Interesting article giving the perspective of someone who has been away from TiddlyWiki for a few years:
Way back in the mists of time (actually, January 2009) I wrote about a really cool tool called TiddlyWiki, a “non-linear personal web notebook”. Fast forward to today and I just had an out of body experience: Completely by accident I found a TiddlyWiki that I started when I wrote that piece and it still works!
Finding code that works flawlessly after just two or three years is magical enough but after seven years?! And given that TiddlyWiki is written as a single page Web application and considering how different browsers are now than they were in 2009, the fact that the old version of TiddlyWiki still works is not short of miraculous.
Un carnet de thèse, basé sur TiddlyWiki.
Voici un exemple de carnet de thèse réalisé avec TiddlyWiki 5.0.8-beta.
TiddlyWiki est un très beau logiciel de Jeremy Ruston. Il vous permet, entre autres choses, de prendre des notes, de gérer vos idées, de garder des informations, et d'afficher un tas de choses de la façon que vous choisirez. C'est un outil incroyablement malléable que vous pouvez adapter à la plupart de vos besoins.
Ce TiddlyWiki a été personnalisé pour être utilisé comme un carnet de notes sur la philosophie, récapitulant auteurs, ouvrages, articles, concepts, théories, et notes personnelles. Je l'utilise avec Zotero, un logiciel spécialisé de bibliographie. Les deux sont des projets libres et ouverts. TiddlyWiki peut-être téléchargé sur https://tiddlywiki.com.
A desktop application for TiddlyWiki, running on Windows.
https://lamusia.github.io/#ATWiki
TiddlyWiki for Windows. A unique non-linear notebook for capturing, organising and sharing complex information.
buggyj a créé plusieurs plugins utiles, notamment un éditeur HTML WYSIWYG, un calendrier configurable et des listes de tags réagençables par simple glisser-déplacer.
Une collection de diverses personnalisations et macros, par Danielo Rodriguez.
Ceci est mon fichier tiddlywiki de test personnel.
Ici, je posterai les outils et macros que je développe pour ce merveilleux outil. Ainsi, toute l'aide que j'ai reçue de la communauté retourne à la communauté.
Une adaptation pour TiddlyWiki version 5 du système GTD® adapté pour TiddlyWiki, connu précédemment sous le nom de MonkeyGTD.
Briefcase est un outil Getting-Thing-Done pour TiddlyWiki5 basé sur le mGSD classique pour TiddlyWiki.
Task & Delegation Tracking, Meetings & Agenda Items, Project Roles, Progress & Status Updates, Reference Items, Tickler Calendar, Conversation Logging, Book Notes & Library, and More!
Cardo is a standalone, browser-based tool that can be used as a simple task manager, or as a complex Project Management system (and indeed, I do use it this way in my daily work) as well as a fully Wiki-ized personal knowledge store. It runs completely independently in the browser, even without an Internet connection, making it possible to carry around on a USB stick, or to use on the morning commute.
Un adaptateur qui permet à TiddlyWiki de synchroniser les modifications avec une base de données CouchDB.
L'adaptateur CouchDB pour TiddlyWiki 5. Nécessite une version de TiddlyWiki >= 5.1.2.
Fonctionne après des tests limités. Difficile de garantir qu'il gère les conflits correctement.
A guide to creating a baby journal with TiddlyWiki.
http://a-penguin-in-redmond.blogspot.co.uk/2014/02/creating-baby-journal-with-tiddlywiki-5.html
Keeping a journal about your baby is fun. It allows you to keep track of those events in your baby's life and development that are most important to you, and to tell them in your own words. [...]
There are plenty of online services that can help to keep such a diary, but you need to have an internet connection to access them, and you have to trust them to keep your data safe.
A TiddlyWiki plugin for kanban-like organization in the style of Trello™ using boards, lists, and cards.
Dynamic Tables is a set of macros that allow you to create tables where the rows are created from tiddlers and the columns from the tiddler fields, or where the columns are created from tiddlers and the rows from their fields. Individual cells can be edited on the fly. Row tables can be sorted by columns and column tables can be sorted by rows.
A plugin that allows to encrypt your tiddlers individually Danielo Rodriguez.
http://danielorodriguez.com/TW5-EncryptTiddlerPlugin/
Advantages:
- You can specify a different password for each tiddler if you want.
- You don't have to encrypt your whole wiky.
- If you forget your password, you only lose a tiddler.
- It's possible to edit the tiddler content , tags and fields except the encrypt field after encryption.
- [...]
An extension for Mozilla Firefox that smoothes out some of the friction from TiddlyWiki's built-in HTML5 fallback saver, making it almost as easy to use as TiddlyFox. The workflow is intended to work out of the box, without configuration.
https://github.com/pmario/file-backups which contains links to the documentation and introduction video(s).
A chrome version is planned!
This wiki gives examples for various filters and their use in the list widget
http://tobibeer.github.io/tw/filters/#Filter%20Examples
This wiki gives examples for various filters and their use in the list widget. A good starting point to understand what filters yield which results also is test-filters.js.
An adaption of the "Ghostwriter" theme for TiddlyWiki.
https://ibnishak.github.io/ghostwriter/
Ghostwriter is a popular, minimalist and mobile responsive theme for the blogging platform ghost. This is an adaptation for TiddlyWiki.
Creates bubble maps of Biblical texts.
http://giffmex.org/gospels.bubbles.html#Gospels%20Bubbles
This TiddlyWiki, which is still under construction, has several features that together make it lightning fast to find passages, types of passages, themes, people, places and images in the New Testament Gospels. The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
- The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
- See how the different types of passages are distributed throughout each Gospel.
- Hover over passages to see the verses and titles.
- Click on a passage to open it and see the themes and other data it mentions.
- The themes by passage indexes are lists of the passages in each Gospel, followed by the themes and other data found in the passage. Clicking on a theme calls up a list of all the passages that mention that theme.
- The indexes of themes contain lists of links to each theme, person, group, place and image. Clicking on a theme calls up a list of all the passages that mention that theme.
- There is a search window hidden in the right hand menu. Use the search window to find passages quickly, by typing things like sower or paralytic. Click the arrows in the upper right of the screen to open the menu and search.
An adaptation of the TiddlyWiki powered GTD® system formerly known as MonkeyGTD for TiddlyWiki version 5.
GSD5 is a Getting-Thing-Done tool for TiddlyWiki5 based off the mGSD classic TiddlyWiki.
Thomas Elmiger
26 décembre 2016 à 19h39
A collection of helpers by Thomas Elmiger, among them a tweet button macro, a text-stretch solution, a snippet extraction macro and a tiddler that installs a scroll-to-top button via drag-and-drop.
Quick Extensions for TiddlyWiki 5 – […] As I take from the community, I am happy if I can give back. You can use my stuff to do whatever you like, but remember to save a back-up first.
Thomas
A guide in Russian to creating an online shop with TiddlyWiki. No serverside code is needed, instead orders are handled by Disqus.
Tony Ching's quick guide for sharing TiddlyWiki with Google Drive.
https://googledrive.com/host/0B51gSXixfJ2Qb0I4R2M4MWJVMlU
Anyway your self-contained a non-linear personal web notebook can be hosted on Google Drive, a free cloud service from Google.com. Because TiddlyWiki5 now supports the Stanford Javascript Crypto Library (SJCL), you can encrypt your content from prying eyes (excluding the NSA of course)
An explainer about Twederation, a system of sharing information between TiddlyWiki instances.
TWederation is a system for sharing information between participating TiddlyWikis without using a client-server model. The link here points to a tiddler that gives more details. This particular implementation works something like an online forum. On the rest of the site, you can follow discussions by the developers and collaborators occurring within the Twederation "network" itself.
An extensive collection of hints and tips from Jed Carty.
http://inmysocks.tiddlyspot.com
I made this so that some of my friends with absolutely no coding experience could use some of the better features of TW5 without having to learn much. I am hopefully going to continue updating it as I learn new things. There isn't really anything here that isn't available in plenty of other places, but I figured that since I spent a while putting it together and people keep saying that TW needs more documentation I would post it here.
A step by step guide to running TiddlyWiki on a CentOS Virtual Private Server.
http://www.rosehosting.com/blog/install-and-run-tiddlywiki-on-a-centoos-6-vps-using-nginx/
In this tutorial we will guide you through the steps of installing and running TiddlyWiki on a CentOS 6 VPS.
We will also install and configure Nginx as a reverse proxy, so you can run TiddlyWiki behind Nginx.
A complete online shop made in TiddlyWiki!
A collection of extensions by @malgam
http://malsandbox.tiddlyspot.com
The "loadnew" plugin provides the JavaScript module $:/plugins/malgam/loadnew/loadnew.js that implements an incremental load command for Tiddlywiki 5.
The javascript code is based on the built-in module $:/core/modules/commands/load.js that loads tiddlers from a Tiddlywiki file into a node.js Tiddlywiki instance. This command loads all non-system tiddlers, irrespective of whether they have been modified since last loaded. As a result, all tiddlers in the node.js tiddlers folder will end up with a new modification date.
In contrast, the loadnew command only loads tiddlers that either don't already exist in the tiddlers folder, or have a newer modified date than the existing tiddler.
With a backup strategy that uses a file system snapshot process to preserve historical versions of tiddlers, the loadnew command minimises the sizes of the resulting snapshots.
Mathcell allows spreadsheet-like abilities in a completely contained TiddlyWiki.
http://mathcell.tiddlyspot.com/
Mathcell allows spreadsheet-like abilities in a completely contained TiddlyWiki. Additional abilities allow it work as a general math engine.
A Spanish guide to using TiddlyWiki on Android.
http://3palmeras.wordpress.com/2014/11/05/microblogging-con-tiddlywiki/
Tiddlywiki software is prodigious based on javascript which is capable of holding a notepad that can be edited with Internet Explorer or function as a full blog, contained in a single file.
Translation by Google Translate
An adaption of the "Moments" theme for TiddlyWiki.
http://tesseractmoments.surge.sh/
Moments is a beautiful free and responsive theme available for wordpress from here: http://www.s5themes.com/theme/moments/. This is an adaptation of the same for TW5 platform. All the design credits goes to the site and the original designer. If TW5 is going to be here for 25 years, might as well suit up.
A terrific demo of drag and drop, pan and zoom, and other sophisticated touch effects. Based on the muuri plugin by Uwe Stuehler.
NoteSelf is your personal, private, customizable, Evernote-like experience. You want cloud? Fine! You don't? Fine too! It's all yours, It's your decision! Why not be a bit selfish?
NoteSelf is the perfect place to store your ideas, notes, thoughts, tips, tricks, recipes... whatever you want to put into it! NoteSelf will store, index, and make it easily searchable, so you will find it instantly whenever you need it!
You already know and love Evernote, we know it. It is comfortable, it syncs, has search capabilities... Wow, it's almost perfect, but what about:
- Privacy - Everything is stored on the Evernote's servers!
- Customization - If you don't like the interface of Evernote, there's nothing you can do
NoteSelf is built on top of TiddlyWiki, a powerful, free, highly customizable and open-source personal wiki. We took the best of it, it's powerful customization system, and mixed it with one of the best embedded databases available, PouchDb, for bringing the synchronization capabilities you need.
A quick guide to using TiddlyWiki (written in German)
http://michaelsonntag.net/notizen-mit-tiddlywiki-systemuebergreifend-nutzen
Those using multiple different computer platforms (if only PC and Android) knows for certain: You would like to sync notes across computers and thereby be independent of any apps or services. I am concerned at any rate so and so I am constantly looking for the perfect solution.
With TiddlyWiki I found it mostly. As the name suggests, it TiddlyWiki is a Wikisystem. In contrast to all other wikis, TiddlyWiki is a single HTML file that runs in the browser and thus can be used on all modern operating systems. And because there is only one file, it can be very easily via the well-known cloud services (Dropbox, Google Drive, ownCloud) or synchronized with FTP or used on a USB stick.
(Translation from German by Google Translate)
Un interprète Forth véloce pour le Commodore PET, écrit en langage assembleur 6502. Le TiddlyWiki contenant la documentation du programme est automatiquement engendré à partir du code source : voir https://github.com/chitselb/pettil.
Les objectifs du projet étaient, sans ordre particulier :
- faire un interpréteur Forth exécutable sur mon Commodore PET 2001
- prendre du plaisir
- développer mes compétences en "assembleur 6502"
- trouver d'autres personnes intéressées par le projet
An extension for Google Chrome and Mozilla Firefox that smoothes out some of the friction from TiddlyWiki's built-in HTML5 fallback saver, making it almost as easy to use as TiddlyFox once it is set up correctly.
Detailed description of setting up TiddlyWiki on Node.js on OS X.
http://undefinedvalue.com/2015/04/02/setting-personal-tiddlywiki-server-os-x
For a new job, I decided to set up a personal wiki to keep notes. I wanted to keep it simple, meeting these requirements:
- All the data is in a Dropbox folder (so it can be automatically synced between machines)
- It must support Markdown syntax
After looking at the options, I settled on TiddlyWiki. I've used "classic TiddlyWiki" before, and liked its simplicity, but I was always a little annoyed with the weird steps you have to go through to save changes. The new version of TiddlyWiki includes support for running it as a real HTTP server, so you can use it just like an online wiki.
But it took me a couple of hours to figure out how to set that up. The TiddlyWiki documentation is not clear ("not clear" is a euphemistic way of saying "terrible"). So, I've written up these instructions in the hope it will spare somebody else all the frustration I had.
A gamers guide to using TiddlyWiki.
http://helugame.wordpress.com/2013/09/07/shining-ark-7-using-tiddlywiki/
I’ve been using TiddlyWiki for this game mainly to record the monsters’ locations and the items that they drop. This is so that when I need a certain item to upgrade/create weapons, I can quickly look it up; which monsters drop it and which quests have those monsters.
As I play the game, as I encounter new information, I just input them into my Shining Ark TiddlyWiki. It’s like I’m building a wiki from scratch. The reason why I don’t just use online wikis is that 1) it’s too easy to get spoiled and 2) sometimes online wikis provide too much information (who cares about the non-gameplay related descriptions that can be found in the game, etc).
A collection of plugins by Stephen Kimmel, including a number of additional editor toolbar buttons.
http://skplugins.tiddlyspot.com/
In keeping with the general spirit of the TiddlyWiki community, ie, you develop something useful and/or potentially interesting you share it with others, I'm sharing some of the plugins I've developed to go with the new Editor Toolbar. You'll find them and a more extensive discussion of what each does at http://skplugins.tiddlyspot.com/
Slides and Stories is a repository of the tools to optimize TW for scientific research and for presenting and publishing results.
http://slidesnstories.tiddlyspot.com
SlidesnStories
...is a tool to save and reload sets of Tiddlers. This is already working, The aim is to develop a mechanism to transform these into instant slideshows.
MetaTabs
is a tool which gives you the possibility to attach and show specific information in tabs at the bottom of each Tiddler: ideas, notes, tasks, stories and presentations, comments, annotations and footnotes.
It is inspired by MagicTabs and Tiddlyscholar by Alberto Molina Pérez, which are very elaborated tools that alas do not seem to be in active development any more. I wanted to change the behaviour in some ways. For example I wanted show tabs only if they have content....furthermore there is
- an export-plugin,
- a footnote-plugin,
- and a plugin to rearrange Tiddlers in the StoryRiver
An enormous collection of tips beautifully curated by Tobias Beer. It is actually a collection of sites, with sub-sites dedicated to topics such as filtering (http://tobibeer.github.io/tw/filters/).
http://tobibeer.github.io/tb5/
A collection of references and sandbox for testing concepts around TiddlyWiki 5...
A Kanban implementation for TiddlyWiki with a familiar look and feel (see the demo).
https://ibnishak.github.io/Tesseract/projects/tekan/Tekan.html
This is Tekan, a TW based kanban. The easiest way to know tekan is to use it. So let us begin, shall we?
TiddlyServer is a special purpose Desktop app, designed to facilitate managing multiple instances of TiddlyWiki running as a server. It does not require internet acess to access the wikis.
https://github.com/mklauber/TiddlyServer/releases/
TiddlyServer can import both TiddlyWiki files and TiddlyFolder wikis. For each wiki, you specify a prefix to serve it with and the source to import from. It will copy the wikis to its own internal store and begin serving them up at http://localhost:8080/{prefix}/. The export button for each wiki will convert it to a single file wiki.
Reaction to TiddlyWiki5 from the translator of the German edition of TiddlyWikiClassic.
http://blog.netplanet.org/2014/01/03/tiddlywiki-5-im-betatest/
There is little software that can still inspire me so even after years, as on the first day. This includes TiddlyWiki, the "pocket-wiki". The latter is because the Wiki completely fits into an HTML file, and this HTML file brings everything - JavaScript program logic, CSS appearance and the entire Wiki content as stored records. So a TiddlyWiki file is then sometimes happy times some megabytes in size, but just has the unbeatable advantage that it works just as fast file created locally in a variety of browsers.
(Translation from German by Google Translate)
Une version préliminaire d'une édition de TiddlyWiki adaptée à la prise de notes universitaire.
http://tw5.scholars.tiddlyspot.com/
TiddlyWiki for Scholars est une personnalisation de TiddlyWiki 5.0.13-beta, que j'ai écrite en pensant à la prise de notes à partir de lectures, mais qui peut servir à d'autres choses. L'idée est de montrer et de faciliter la création des données liées au tiddler courant sans quitter le tiddler.
Une collection de trucs et astuces en Français, introduits par ce post de blog :
http://sylvain.naud.in/post/2014/10/29/Ressources-pour-TiddlyWiki-5-%28FR%29
Ce guide de prise en main de TiddlyWiki vous permettra de débuter sur ce logiciel : rédiger du texte avec la syntaxe wiki, insérer des images, créer des Tiddler, faire une recherche, ajouter des fonctionnalités, et bien d'autres choses.. Bonne lecture ! Sylvain
A Knowledge Network about TiddlyWiki.
http://confocal-manawatu.pbworks.com/w/page/113574373/TiddlyWiki
Interconnected with the visual taxonomy at every node: http://debategraph.org/Stream.aspx?nid=457381&vt=bubble&dc=focus
TWKN will be transferred into TWederation/TiddlyMap format as soon as I am convinced in reliable and secure versioning and multi-user operation in TW format. Your assistance and support would be highly appreciated.
Notes and tips by a developer working on writing TiddlyWiki plugins – including TWExe, a widget for running Windows scripts and executables.
A collection of articles covering integration with Fargo, Font Awesome and Google Calendar, and tips for managing task lists.
http://blog.jeffreykishner.com/tiddlywiki/
I have become a regular user of TiddlyWiki and have become so accustomed to using Font Awesome icons in Fargo that I wanted to incorporate the icons into my wikis as well.
A topical index of known plugins, tutorials, themes, and other helpful tools for TiddlyWiki.
https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM
Some of the topics indexed so far include:
- Background images and background colors
- Breadcrumbs
- Business - examples
- CSS / Styles, general
- Calendars, dates and timelines
- Checklists
- Collaboration
- Color palettes
- Colors
- Data visualizations
- Developer / advanced tools
- Diplay tiddlers horizontally
- Dropdowns
- Educational
- External files
- Fields
- Fonts
- Fun and games
- Home and lifestyle
- IFrames and embedding media
- Image galleries, modals and lightboxes
- Images, icons, emojis
- Importing and exporting between TiddlyWiki files
- Includes scaffolding within a tiddler, dragging to reorder tiddlers, choosing the number of columns
- Interfacing with, importing and exporting to and from other formats
- Knowledge bases, dictionaries and glossaries
- Layout/UI
- Lightboxes
- Links, linking
- Lists and filters
- Maps and geography
- Masonry, scaffolding
- Math
- MindMapping
- Mobile tools
- Music and sound
- Navigation
- node.js
- Note-taking
- Open the "filter" tab
- Partially hidden tiddlers
- Personal websites (examples)
- Presentations and slideshows
- Printing
- Project management
- Publishing and hosting TiddlyWikis on the web
- Searching tools
- Security and backup tools
- Social media, sharing, comments
- Spreadsheets and math
- Startup
- Sticky titles
- Story and screenplay creation
- Table of contents
- Tables, charts and graphs (cf data visualizations)
- Tabs
- Tags, tagging
- Task management and productivity - to do lists
- Themes
- Understanding TiddlyWiki
- Writing and editing
Dutch blog post about TiddlyWiki
https://breinbout.wordpress.com/2014/11/26/tiddlywiki/
I'm allergic to websites that are highly dependent on JavaScript. I think that JavaScript has many useful applications to add functionality to a site, but content needs to be visible if JavaScript is switched off. I use the NoScript extension for Firefox and surf with pleasure over the Internet without spontaneous things happen that I do not give permission. I love JavaScript on a short leash. More crazier maybe I'm so excited about TiddlyWiki.
(Translation from Dutch by Google Translate)
Une collection importante de trucs et ressources pour les utilisateurs de TiddlyWiki en Japonais.
TiddlyWikiをHTML5にしたTiddlyWiki5が正式にリリースされました。このTiddlyWiki5の使い方について、自分で試した機能を中心に解説します。
TiddlyWiki5は、非常に多機能なローカルWikiです。このブログに書いてあることは、TiddlyWiki5で出来ることのごく一部です。
Chris Hunt's detailed developer tutorials for getting started with writing widgets for TiddlyWiki.
These pages document aspects TiddlyWiki5 programming, sharing "lessons learned" to help developers to get started with TiddlyWiki5 customization and extension.
There are currently two articles in this wiki:
- A Simple Widget
- A More Complex Widget
A TiddlyWiki5 forum on Reddit.
https://www.reddit.com/r/TiddlyWiki5/
A TiddlyWiki5 forum on Reddit. As of 2016, it claims to have the most up-to-date list of plugins available for TW5.
Huge collection of customisations and tweaks from Ton Gerner.
http://tongerner.tiddlyspot.com/
I am a longtime user of TiddlyWiki Classic and still use it daily since you can't do everything in TiddlyWiki 5 (yet) ;)
I started experimenting with TW5 at the end of September 2013 (alpha10). Since I missed a few things in the layout I got used to in TiddlyWiki Classic 1, I started with modifying the layout of TW5. To share my knowledge, I made a few guides about these 'modifications'. The guides started as a non-linear personal web notebook (yeah, the subtitle of TiddlyWiki!). I started experimenting with layout things and used TW5 to document my experiments.
A wealth of hints, tips and notes about using TiddlyWiki on Node.js:
http://larigot.avarts.ionio.gr/users/iani/wikis/tw5square.html
TiddlyWiki is different from other wikis because of its principle of dynamically customizeable "storyline" based on tiddlers as basic units of information. That is, the user "composes" their own version of the webpage by clicking on tiddler links, which add tiddlers to the page in order to compose a storyline.
The Node.js implementation in TiddlyWiki5 adds all the advantages of flat-file markup language based type of site. This makes TiddlyWiki an excellent alternative to flat-file based CMS/webpage/blog authoring systems for the web.
Also very cool is the treatment of tags as menus everywhere.
Timimi is a Web Extension and executable for Firefox, Chrome and Chromium that allows it to save standalone TiddlyWiki files.
https://github.com/ibnishak/Timimi
This is an addon using native messaging, essentially handing over the contents to a webextension host (executable) which does the actual saving. Once installed, you can save the standalone TW from anywhere in your hard drive without any more interactions, like the original Tiddlyfox addon.
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
http://tw5magick.tiddlyspot.com/
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
Tips and guides for using TiddlyWiki.
http://techlifeweb.com/tw5tribalknowledge.html
I never used Node.js until a couple weeks ago when I wanted to try a TW5 installation on Node and expand my knowledge a bit. I figured someone else may be in the same boat so I wrote it all down
An alternative LaTeX plugin for TiddlyWiki5. It supports a wider set of LaTeX commands than KaTeX, though not as extensive as MathJax
http://tw5-texzilla.tiddlyspot.com
This plugin provides LaTeX support in TiddlyWiki5, using the TeXZilla latex parser to generate MathML.
Only Firefox and Safari support MathML at the moment, so the plugin is only useful if you're using one of these browsers. It might be possible to combine this plugin with MathJax to convert MathML to something that other browsers can understand, e.g. HTML+CSS, but I haven't tried this.
A collection of TiddlyWiki resources from Mario Pietsch, with a focus on cloud deployments. Mario also maintains the German translation of TiddlyWiki.
My name is Mario Pietsch from Austria. I'm living near Salzburg.
This page, will be the portal to my TiddlyWiki, TiddlyWeb related content.
Un manuel d'utilisation de TiddlyWiki (en Français) sur BiblioBox, une des variations de la PirateBox, système mobile de transfert et partage de fichiers.
http://bibliobox.net/blog/post/2014/07/16/un-wiki-sur-votre-bibliobox-avec-tiddlywiki
J'ai connu TiddlyWiki à ses débuts en 2004. Je l'utilisais régulièrement comme bloc-notes de façon personnelle ou professionnelle en 2007 et 2012. Mais j'admets avoir ignoré cet outil pendant les deux dernières années. Et voilà que je me suis dit hier : mais pourquoi ne pas mettre TiddlyWiki sur une BiblioBox ? puisque c'est un simple fichier HTML avec du javascript. De plus je connaissais l'existence d'une version serveur pour sauvegarder les modifications en ligne.
A collection of references for testing concepts around TiddlyWiki 5...
This is PMario's playground with ramblings about TiddlyWiki and related stuff.
It basically is a "jump off" page to various TiddlyWiki sites, that show editions, themes and plugins.
Matabele's stylish and clean system for personal task management.
This is my work in progress version of TW5, incorporating various features and ideas as and when they intrigue me. To grab any feature you may wish to try, drag the listed tiddlers across to the dropzone of an empty TiddlyWiki 5.0.10-beta
An experiment to embed interactive 3D graphics within TiddlyWiki by Jamal Wills. It is based X3DOM, an open source JavaScript library.
TiddlyWiki est un outil incroyablement souple et polyvalent, conçu et mis au point d'une façon très différente que la plupart des logiciels. Cela peut paraître très difficile à comprendre jusqu'au moment où les premiers click le font devenir un extension directe de votre cerveau.
Pour commencer par les bases, TiddlyWiki est une application web dédiée à la prise de notes, que vous pouvez obtenir gratuitement, stocker n'importe où, et personnaliser selon vos souhaits. Elle vous servira à conserver, organiser, et partager vos notes de manière inédite en comparaison des traitements de texte et autres outils habituels de prise de notes.
TiddlyWiki privilégie la non-linéarité : le contenu se structure à l'aide de déroulés, de tags, d'hyperliens, et d'autres fonctionnalités spécifiques. Vous pouvez organiser vos notes et y accéder selon votre manière de penser, sans vous sentir contraint par une structure d'organisation prédéfinie.
Vous pouvez utiliser TiddlyWiki sous forme de fichier autonome, affichable et éditable depuis n'importe quel navigateur web, que vous soyez connecté ou déconnecté. Vous pouvez aussi vous en servir comme une application Node.js, à même de synchroniser chacune de vos notes dans un fichier séparé.
Comment faire fonctionner TiddlyWiki chez vous ? Notre conseil est de commencer par lire les textes de présentation ci-dessous, puis de naviguer dans la table des matières présente dans l'onglet Sommaire de la barre latérale. Ou si vous préférez, contentez-vous de suivre nos instructions de démarrage et jetez-vous à l'eau !
- Découvrez TiddlyWiki
- Certaines choses que vous pouvez faire avec TiddlyWiki
- Dix raisons de passer à TiddlyWiki
- Exemples d'utilisation
- Histoire de TiddlyWiki
- Qu'est-il arrivé au TiddlyWiki d'origine ?
- Un mini-guide de TiddlyWiki
Voir aussi :
- Developer Documentation (en anglais)
Informations sur le développement de TiddlyWiki :
A plugin to integrate the Ace editor into TiddlyWiki.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
TiddlyWiki n'aurait pas été possible sans le soutien constant de la Communauté. Son attention et ses retours ont permis de comprendre ce qui était attendu de cet outil, et sa passion pour le projet m'a appris que le jeu en valait la chandelle.
TiddlyWiki intègre du code provenant de ces excellents projets OpenSource :
- The Stanford Javascript Crypto Library
- The Jasmine JavaScript Test Framework
- Normalize.css by Nicolas Gallagher
Et des contenus provenenant de ces sources :
- Icônes des drapeaux du monde de Wikipedia
Introduction
The action-createtiddler widget is an action widget that creates new tiddlers. ActionWidgets are used within triggering widgets such as the ButtonWidget.
There are several differences from the tm-new-tiddler message:
- The new tiddler is not automatically displayed in the story river
- The title of the new tiddler is made available for subsequent operations
Content and Attributes
The action-createtiddler widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $basetitle | The initial title that will be attempted. If a tiddler with that title already exists, then a numerical counter is added to the title and incremented until it is unique |
| $savetitle | A text reference identifying a field or index into which the title of the newly created tiddler will be stored after it is created |
| $timestamp | Specifies whether the timestamp(s) of the target tiddler will be updated (modified and modifier, plus created and creator for newly created tiddlers). Can be "yes" (the default) or "no" |
| {any attributes not starting with $} | Each attribute name specifies a field to be created in the new tiddler |
Examples
New button caption: <$edit-text tiddler="$:/state/new-button-caption" tag="input" default=""/>
<$button>
<$action-createtiddler $basetitle="Homemade Button" tags="$:/tags/PageControls" text={{$:/state/new-button-caption}}/>
Create non-functional page control button
</$button>Affichera ceci :
New button caption:
Introduction
The action-deletefield widget is an action widget that deletes specified fields of a tiddler. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-deletefield widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $tiddler | The title of the tiddler whose fields are to be modified (if not provided defaults to the current tiddler) |
| $field | Optional name of a field to delete |
| {any attributes not starting with $} | Each attribute name specifies a field to be deleted. The attribute value is ignored and need not be specified |
Examples
Here is an example of a button that deletes the caption and tags fields of the current tiddler:
<$button>
<$action-deletefield caption tags/>
Delete "caption" and "tags"
</$button>Affichera ceci :
Here is an example of a button that deletes the modified date and tags fields of the tiddler HelloThere:
<$button>
<$action-deletefield $tiddler="HelloThere" modified tags/>
Delete "modified" and "tags" from ~HelloThere
</$button>Affichera ceci :
Here is an example of a button that uses the optional $field attribute to delete the text field of the tiddler HelloThere:
<$button>
<$action-deletefield $tiddler="HelloThere" $field="text"/>
Delete text from ~HelloThere
</$button>Affichera ceci :
Introduction
The action-deletetiddler widget is an action widget that deletes tiddlers. ActionWidgets are used within triggering widgets such as the ButtonWidget.
There are several differences compared to the WidgetMessage: tm-delete-tiddler:
- The user is not prompted to confirm the deletion
- No automatic updating of the story list
- No special handling of draft tiddlers
Content and Attributes
The action-deletetiddler widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $tiddler | Optional title of the tiddler to be deleted |
| $filter | Optional filter identifying tiddlers to be deleted |
Examples
Here is an example of a button that deletes the tiddler HelloThere:
<$button>
<$action-deletetiddler $tiddler="HelloThere"/>
Delete "~HelloThere"
</$button>Affichera ceci :
Here is an example of a button that deletes all tiddlers tagged TableOfContents:
<$button>
<$action-deletetiddler $filter="[tag[TableOfContents]]"/>
Delete tiddlers tagged "~TableOfContents"
</$button>Affichera ceci :
Introduction
The action-listops widget is an action widget that manipulates user lists in any field or data index. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-listops widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $tiddler | The title of the tiddler whose lists are to be modified (if not provided defaults to the current tiddler |
| $field | The name of a field to be manipulated as a list (defaults to 'list') |
| $index | Optional index of a property in a data tiddler index to be manipulated as a list |
| $filter | An optional filter expression, the output of which will be saved to the field/index being manipulated |
| $subfilter | An optional subfilter expression, which takes the list being manipulated as input, and saves the modified list back to the field/index being manipulated |
| $tags | An optional subfilter expression, which takes the 'tags' field of the target tiddler as input, and saves the modified list of tags back to the 'tags' field |
Extended Filter Operators
A number of extended filter operators are necessary for the manipulation of lists. These operators have been designed primarily for use in subfilter expressions whereby the modified current list is returned in place of the current list.
| Listops Operators | ||
|---|---|---|
| Operator | Purpose | |
| allafter | discard all items except those after the marker | |
| allbefore | discard all items except those before the marker | |
| append | append a range of items from an array to the list | |
| insertbefore | insert an item T into a list immediately before an item B |
|
| move | move marker N places in the list | |
| prepend | prepend a range of items from an array to the list | |
| putafter | move N trailing items after the marker | |
| putbefore | move N trailing items before the marker | |
| putfirst | move N trailing items to the head of the list | |
| putlast | move N leading items to the tail of the list | |
| remove | remove a list of titles specified in the operand from the input | |
| replace | replace marker with N trailing items | |
| sortby | sort the current list in the order of the list referenced in the operand | |
Examples
In this example we shall populate and then clear a list in an ordinary field (myfield) of this tiddler (the default.)
<$button>
<$action-listops $field="myfield" $subfilter="efg hlm pqr"/>
Populate 'myfield'
</$button>
<$button>
<$action-listops $field="myfield" $subfilter="abc xyz"/>
Append More Items
</$button>
<$button>
<$action-listops $field="myfield" $subfilter="-abc -hlm"/>
Remove Items
</$button>
<$button>
<$action-listops $field="myfield" $filter="[[]]"/>
Clear 'myfield'
</$button>
<$list filter="[list[!!myfield]]">
</$list>Affichera ceci :
In this example we shall append and remove items from a list in an ordinary field (myfield) of this tiddler (the default) and sort the resultant list. We shall then remove some of the appended items and sort the resulting list in reverse order.
<$button>
<$action-listops $field="myfield" $subfilter="-efg ijk xyz [[this is a title]] +[sort[]]"/>
Mangle List
</$button>
<$button>
<$action-listops $field="myfield" $subfilter="-xyz -[[this is a title]] +[!sort[]]"/>
Unmangle List
</$button>
<$list filter="[list[!!myfield]]">
</$list>Affichera ceci :
In this example we shall append a few tags to the 'tags' field of this tiddler (the default.) We shall then remove some of the appended tags.
<$button>
<$action-listops $tags="+[append{Days of the Week!!short}] $:/tag1 $:/tag2 $:/tag3"/>
Populate 'tags'
</$button>
<$button>
<$action-listops $tags="+[!remove:2{!!tags}]"/>
Remove Last Two Tags
</$button>
<$button>
<$action-listops $tags="+[!prefix[$:/]]"/>
Remove System Tags
</$button>
<$button>
<$action-listops $tags="-Mon -Tue"/>
Remove Mon and Tue
</$button>
<$button>
<$action-listops $tags="+[prefix[$:/]] ActionWidgets Widgets"/>
Remove User Tags
</$button>
<$button>
<$action-listops $tags="+[[]] ActionWidgets Widgets"/>
Clear Tags
</$button>
<$list filter="[list[!!tags]]">
</$list>Affichera ceci :
Introduction
The action-navigate widget is an action widget that sends a tm-navigate message back up the widget tree. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-navigate widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $to | The title of the target tiddler for the navigation (if not provided defaults to the current tiddler |
| $scroll | Optional parameter determining whether the navigation will also cause a scroll to the target tiddler (see below) |
Scroll handling
The optional $scroll attribute can be set to "yes" to force scrolling to occur to bring the target tiddler into view. If set to "no" then scrolling does not occur. If the $scroll attribute is omitted then scrolling occurs unless either:
- the control key is pressed
- the action was initiated with the middle mouse button (if available)
Note that if navigating to multiple tiddlers at once you should use the same $scroll setting for all of them.
Examples
Here is an example of button that navigates to two different tiddlers at once:
<$button>
<$action-navigate $to="ButtonWidget"/>
<$action-navigate $to="ActionWidgets"/>
Click me!
</$button>Affichera ceci :
Introduction
The action-sendmessage widget is an action widget that sends a message back up the widget tree. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-sendmessage widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $message | The message to send (eg, WidgetMessage: tm-new-tiddler) |
| $param | Optional parameter string whose meaning is dependent on the message being sent |
| $name | Optional name of additional parameter |
| $value | Value for optional parameter whose name is specified in $name |
| {any attributes not starting with $} | Multiple additional, optional named parameters that are attached to the message |
Examples
Here is an example of button that displays both a notification and a wizard, and creates a new tiddler with tags and text:
<$button>
<$action-sendmessage $message="tm-modal" $param="SampleWizard"/>
<$action-sendmessage $message="tm-notify" $param="SampleNotification"/>
<$action-sendmessage $message="tm-new-tiddler" title="This is newly created tiddler" tags="OneTag [[Another Tag]]" text=<<now "Today is DDth, MMM YYYY">>/>
Click me!
</$button>Affichera ceci :
Introduction
The action-setfield widget is an action widget that assigns values to the fields of a tiddler. ActionWidgets are used within triggering widgets such as the ButtonWidget.
Content and Attributes
The action-setfield widget is invisible. Any content within it is ignored.
| Attribute | Description |
|---|---|
| $tiddler | The title of the tiddler whose fields are to be modified (if not provided defaults to the current tiddler) |
| $field | Optional name of a field to be assigned the $value attribute |
| $index | Optional index of a property in a data tiddler to be assigned the $value attribute |
| $value | The value to be assigned to the field or index identified by the $field or $index attribute. If neither is specified then the value is assigned to the text field. If no value is specified, $field or $index will be deleted. |
| $timestamp | Specifies whether the timestamp(s) of the target tiddler will be updated (modified and modifier, plus created and creator for newly created tiddlers). Can be "yes" (the default) or "no" |
| {any attributes not starting with $} | Each attribute name specifies a field to be modified with the attribute value providing the value to assign to the field |
Examples
Here is an example of a pair of buttons that open the control panel directly to specified tabs. They work by using action-setfield to set the state tiddler for the control panel tabs.
<$button>
<$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Appearance"/>
<$action-navigate $to="$:/ControlPanel"/>
Go to Control Panel "Appearance" tab
</$button>
<$button>
<$action-setfield $tiddler="$:/state/tab-1749438307" text="$:/core/ui/ControlPanel/Settings"/>
<$action-navigate $to="$:/ControlPanel"/>
Go to Control Panel "Settings" tab
</$button>Affichera ceci :
Here is an example of a button that assigns tags and fields to the tiddler HelloThere, and then navigates to it and opens the tiddler info panel on the "Fields" tab:
<$button>
<$action-setfield $tiddler="HelloThere" tags="NewTag [[Another New Tag]]" color="red"/>
<$action-setfield $tiddler="$:/state/popup/tiddler-info--1779055697" text="(568,1443,33,39)"/>
<$action-setfield $tiddler="$:/state/tab--1890574033" text="$:/core/ui/TiddlerInfo/Fields"/>
<$action-navigate $to="HelloThere"/>
Modify ~HelloThere
</$button>Affichera ceci :
Here is an example of a button that assigns tags and fields to the tiddler HelloThere, and then initiates editing it:
<$button>
<$action-setfield $tiddler="HelloThere" tags="MoreTag [[Further More Tags]]" color="green"/>
<$action-sendmessage $message="tm-edit-tiddler" $param="HelloThere"/>
Edit ~HelloThere
</$button>Affichera ceci :
Here is an example of a button that opens the control panel directly to the "Appearance" tabs:
<$button>
<$action-setfield $tiddler="$:/state/tab-1749438307" $field="text" $value="$:/core/ui/ControlPanel/Appearance"/>
<$action-navigate $to="$:/ControlPanel"/>
Go to Control Panel "Appearance" tab
</$button>Affichera ceci :
The variable actionTiddler is used in subtly different ways by different widgets:
- Within the actions string of the DroppableWidget, the actionTiddler variable contains the title of the tiddler being dropped.
- Within the startactions and endactions string of the DroppableWidget, the actionTiddler variable contains a quoted Title List of all of the titles being dragged.
Action widgets are a special type of widget that have no visual appearance but perform an action when triggered (such as sending a message, navigating to a tiddler, or changing the value of a tiddler). Action widgets are used in association with other widgets that trigger those actions (for example, the ButtonWidget).
The following action widgets are provided:
- action-createtiddler
- action-deletefield
- action-deletetiddler
- action-listops
- action-navigate
- action-sendmessage
- action-setfield
There are two ways to use action widgets:
- Using the
actionsattribute of the triggering widget (this is the preferred way) - Embedding the actions within the triggering widget (an older technique that is now deprecated)
Assigning action widgets with the actions attribute
The action widgets are passed as a string to the actions attribute of the triggering widget. Usually, it is more convenient to use a macro to assign the action widgets to a variable. For example, here is a button that triggers two actions of sending different messages:
\define my-actions()
<$action-sendmessage $message="tm-home"/>
<$action-sendmessage $message="tm-full-screen"/>
\end
<$button actions=<<my-actions>>>
Click me!
</$button>Assigning action widgets by embedding
The action widgets need not be immediate children of their triggering widget, but they must be descendents of it. The actions are performed in sequence. Here is the above example rewritten to use embedding:
<$button>
<$action-sendmessage $message="tm-home"/>
<$action-sendmessage $message="tm-full-screen"/>
Click me!
</$button>The standard mechanisms in TiddlyWiki for creating Table-of-Contents are macros known collectively as "toc" macros (click on link to learn more about macros). They use Tagging as their means of creating relationships, so be sure to review the Tagging topic tiddler if tagging is a new concept for you.
A customisable table of contents can be added to the sidebar with the following steps:
- Create a tiddler called TableOfContents
- Give it the tag $:/tags/SideBar
- Set the text to
<div class="tc-table-of-contents"> <<toc-selective-expandable 'TableOfContents'>> </div> - Add a caption field with the text Contents
- Add a list-after field with the text $:/core/ui/SideBar/Open
Add entries to the table of contents by creating tiddlers tagged TableOfContents. An easy way is to choose new here from the tiddler toolbar of the TableOfContents tiddler. (if you don't see the "new here" button, click on the down arrow to see more menu options.)
To create child tiddlers (tiddlers that come below other tiddlers), tag them with the name of the parent tiddler.
Voici une macro qui propose un Bouton suivre sur twitter pour un utilisateur particulier :
\define twitterFollowButton(username)
<iframe allowtransparency="true" frameborder="0" scrolling="no" src="//platform.twitter.com/widgets/follow_button.html?screen_name=$username$" style="width:300px; height:20px;"></iframe>
\endLa seule modification à la version publiée sur https://dev.twitter.com/docs/follow-button est la suppression des nouvelles lignes.
Notez que l'URL src est passée sans protocole (ie "http" or "https"). De cette façon, cela fonctionne que les sites soient sur un domaine en HTTP ou en HTTPS. Si vous voulez aussi que le bouton Twitter fonctionne en utilisant TiddlyWiki horsligne par une URL "file://", vous devrez ajouter manuellement le protocole. Par exemple:
<iframe allowtransparency="true" frameborder="0" scrolling="no" src="http://platform.twitter.com/widgets/follow_button.html?screen_name=jermolene" style="width:300px; height:20px;"></iframe>| purpose | extend each input title with a prefix |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | the input, but with S added to the start of each title |
| purpose | extend each input title with a suffix |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | the input, but with S added to the end of each title |
À mesure que les structures à l'intérieur de vos documents TiddlyWiki se complexifient, il peut être difficile de conserver la cohérence des titres des tiddlers. Par exemple, faut-il définir les termes au pluriel ou au singulier ? Avec la convention « Camel case » ou en séparant les mots ?
Fixer une politique formelle concernant les titres peuvent aider à réduire les risques de confusion. Par exemple, la politique de titres de ce wiki sont :
- Utilisation de mots simples en minuscules pour les tags
- Utilisation de la convention CamelCase pour les définitions et les concepts
- exemples : TiddlerFields, DeveloperDocs
- Utilisation de mots séparés pour les titres qui sont des expressions ou des phrases complètes, comme des FAQ, des howtos ou des tâches
- Là où TiddlyWiki or TiddlyWiki5 est utilisé comme qualifieur au début du titre, toujours utiliser des mots séparés
- exemple : TiddlyWiki sur Node.js
Une politique qui inclurait la règle ci-dessous pourrait s'appliquer à vos propres wikis :
- Utliisation du préfixe
$:/_pour tous les tiddlers système que vous créez pour être sûr de les retrouver en haut de la liste des tiddlers système de la barre latérale.
| purpose | find which input title follows a specified one |
|---|---|
| input | a selection of titles |
| parameter | T = one of those titles |
| output | the title that immediately follows T in the input |
If T is not present in the input, or is the last title there, then the output is empty.
These examples make use of the Days of the Week tiddler. The Thursday tiddler shows a further example.
[list[Days of the Week]after[Monday]]
[list[Days of the Week]after[Sunday]]
Alerts are displayed as yellow boxes overlaying the main TiddlyWiki window. Each one corresponds to a tiddler with the tag $:/tags/Alert. Clicking the delete icon on an alert deletes the corresponding tiddler.
Here's a demo .
Alert tiddlers should have the following fields:
| Field | Description |
|---|---|
| title | By default, alert titles have the prefix $:/temp/alerts/ |
| text | The text of the alert message |
| modified | Date of the alert (used for ordering the alerts on screen) |
| component | Component name associated with the alert |
| tags | Must include $:/tags/Alert |
| purpose | find all titles of a fundamental category |
|---|---|
| input | ignored, unless the parameter is empty |
| parameter | zero or more categories |
| output | the titles that belong to all the specified categories |
The parameter specifies zero or more fundamental categories using the following syntax:
| Category | Members | Sorted |
|---|---|---|
current | just the current tiddler | – |
missing | all non-existent tiddlers to which there is at least one hard link | no |
orphans | all tiddlers to which there are no hard links | by title |
shadows | all the shadow tiddlers that exist, including any that have been overridden with non-shadow tiddlers | no |
tags | all the tags in use on non-shadow tiddlers | no |
tiddlers | all the non-shadow tiddlers that exist | no |
If the parameter specifies more than one category, they are processed from left to right. The overall output is initially empty, and each category's output is dominantly appended to it in turn. Unrecognised categories contribute nothing to the output.
As a special case, if the parameter is empty, the output is simply a copy of the input. This can be useful when the parameter is soft.
The is operator is similar, but its scope is restricted to its input.
[all[shadows]]
[all[shadows+tiddlers]]
[all[tiddlers+shadows]]
[all[orphans+missing+current]]
[all[current]]
[all[current]tag[Operator Examples]]
[all[current]tag[Recipes]]
Monday Thursday +[all[]]
| purpose | discard all items except those after the marker |
|---|---|
| input | a list of items |
| suffix | specifying a suffix ('include') will include the marker in the output |
| parameter | marker = the list item to be used as a marker |
| output | all items after the marker |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[allafter[Wednesday]]
[list[Days of the Week]] +[allafter:include[Wednesday]]
| purpose | discard all items except those before the marker |
|---|---|
| input | a list of items |
| suffix | specifying a suffix ('include') will include the marker in the output |
| parameter | marker = the list item to be used as a marker |
| output | all items before the marker |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]allbefore[Wednesday]]
[list[Days of the Week]allbefore:include[Wednesday]]
Liste des tiddlers non système contenus dans ce wiki :
Here are the details of the alpha releases of TiddlyWiki5. See TiddlyWiki5 Versioning for details of how releases are named.
Release 5.0.1-alpha
Released 6 décembre 2013 at 17:53
See GitHub for detailed change history of this release
Improvements
- Changes to the importing process to enable a smoother Upgrading process
- Ignores attempts to import plugins that are older than currently installed plugins
- System tiddlers are now imported as usual
- If
$:/themeisn't defined or refers to a missing tiddler, then fallback through Snow White to Vanilla. This means thatempty.htmlnow defaults to Snow White - Added support for Block Quotes in WikiText
- Contributed by StephanHradek (@Skeeve on GitHub)
Bug fixes
- Fixed bug that was preventing
$:/tags/PageControlstiddlers from being reordered
Internal changes
- Changed the TiddlyWiki5 Versioning policy
- Beta releases will be
5.0.x-betaand the final release will be5.1.x
- Beta releases will be
The Amazon Web Services Plugin provides several tools for working with Amazon Web Services:
- Templates for saving a TiddlyWiki as a single JavaScript file in a ZIP file that can be executed as an AWS Lambda function. In this form, TiddlyWiki is a self contained single file containing both code and data, just like the standalone HTML file configuration
- Commands that can be used to interact with AWS services, under both the Node.js and Lambda configurations of TiddlyWiki
| purpose | append a range of items from an array to the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to all |
| parameter | list = the array of items to be appended to the tail of the list |
| output | a list with items appended from the head of the operand array |
! output | a list with items appended from the tail of the operand array |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]append[Tomorrow]]
[list[Days of the Week]append[Yesterday Today Tomorrow]]
- Append the first 4 short days of the week to our list
[list[Days of the Week]append:4{Days of the Week!!short}]
Ici quelques articles récents rédigés sur TiddlyWiki. Soumettez les nouveaux articles via GitHub, Twitter ou en postant dans les groupes de discussion TiddlyWiki.
"A free, open source wiki revisited" by Mark Gibbs, NetworkWorld
Posted il y a 2 ans
Interesting article giving the perspective of someone who has been away from TiddlyWiki for a few years:
Way back in the mists of time (actually, January 2009) I wrote about a really cool tool called TiddlyWiki, a “non-linear personal web notebook”. Fast forward to today and I just had an out of body experience: Completely by accident I found a TiddlyWiki that I started when I wrote that piece and it still works!
Finding code that works flawlessly after just two or three years is magical enough but after seven years?! And given that TiddlyWiki is written as a single page Web application and considering how different browsers are now than they were in 2009, the fact that the old version of TiddlyWiki still works is not short of miraculous.
"Setting Up a Personal TiddlyWiki Server on OS X" by Kris Johnson
Posted il y a 3 ans
Detailed description of setting up TiddlyWiki on Node.js on OS X.
http://undefinedvalue.com/2015/04/02/setting-personal-tiddlywiki-server-os-x
For a new job, I decided to set up a personal wiki to keep notes. I wanted to keep it simple, meeting these requirements:
- All the data is in a Dropbox folder (so it can be automatically synced between machines)
- It must support Markdown syntax
After looking at the options, I settled on TiddlyWiki. I've used "classic TiddlyWiki" before, and liked its simplicity, but I was always a little annoyed with the weird steps you have to go through to save changes. The new version of TiddlyWiki includes support for running it as a real HTTP server, so you can use it just like an online wiki.
But it took me a couple of hours to figure out how to set that up. The TiddlyWiki documentation is not clear ("not clear" is a euphemistic way of saying "terrible"). So, I've written up these instructions in the hope it will spare somebody else all the frustration I had.
"TiddlyWiki" by Sander de Boer
Posted il y a 4 ans
Dutch blog post about TiddlyWiki
https://breinbout.wordpress.com/2014/11/26/tiddlywiki/
I'm allergic to websites that are highly dependent on JavaScript. I think that JavaScript has many useful applications to add functionality to a site, but content needs to be visible if JavaScript is switched off. I use the NoScript extension for Firefox and surf with pleasure over the Internet without spontaneous things happen that I do not give permission. I love JavaScript on a short leash. More crazier maybe I'm so excited about TiddlyWiki.
(Translation from Dutch by Google Translate)
"Notizen mit TiddlyWiki systemübergreifend nutzen" by Michael Sonntag
Posted il y a 4 ans
A quick guide to using TiddlyWiki (written in German)
http://michaelsonntag.net/notizen-mit-tiddlywiki-systemuebergreifend-nutzen
Those using multiple different computer platforms (if only PC and Android) knows for certain: You would like to sync notes across computers and thereby be independent of any apps or services. I am concerned at any rate so and so I am constantly looking for the perfect solution.
With TiddlyWiki I found it mostly. As the name suggests, it TiddlyWiki is a Wikisystem. In contrast to all other wikis, TiddlyWiki is a single HTML file that runs in the browser and thus can be used on all modern operating systems. And because there is only one file, it can be very easily via the well-known cloud services (Dropbox, Google Drive, ownCloud) or synchronized with FTP or used on a USB stick.
(Translation from German by Google Translate)
"TiddlyWiki 5 im Betatest" by besim
Posted il y a 5 ans
Reaction to TiddlyWiki5 from the translator of the German edition of TiddlyWikiClassic.
http://blog.netplanet.org/2014/01/03/tiddlywiki-5-im-betatest/
There is little software that can still inspire me so even after years, as on the first day. This includes TiddlyWiki, the "pocket-wiki". The latter is because the Wiki completely fits into an HTML file, and this HTML file brings everything - JavaScript program logic, CSS appearance and the entire Wiki content as stored records. So a TiddlyWiki file is then sometimes happy times some megabytes in size, but just has the unbeatable advantage that it works just as fast file created locally in a variety of browsers.
(Translation from German by Google Translate)
- [attr]
- Represents an element with an attribute name of attr.
- [attr="value"]
- Represents an element with an attribute name of attr and whose value is exactly "value".
- [attr~="value"]
- Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
- [attr|="value"]
- Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
- [attr^="value"]
- Represents an element with an attribute name of attr and whose first value is prefixed by "value".
- [attr$="value"]
- Represents an element with an attribute name of attr and whose last value is suffixed by "value".
- [attr*="value"]
- Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
- [attr "operator value" i]
- Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
Learn more at: Attribute selectors - CSS or CSS-Specification
Audio files can be incorporated into TiddlyWiki in a very similar way to images.
Embedded Audio
Small audio files can be embedded directly within TiddlyWiki. Embedding isn't suitable for large files (over a few hundred kilobytes) because it increases the size of the TiddlyWiki file.
For example, the tiddler TiddlyWiki.mp3 contains an MP3 recording of the word "TiddlyWiki". If you visit that tiddler, you should see an audio player that will play back the recording.
You can also transclude audio files. For example:
{{TiddlyWiki.mp3}}Affichera ceci :
External Audio
External audio tiddlers use the _canonical_uri field to point to an external audio file/stream, and have their text field blocked. This reduces their size considerably, but still allows for playback.
For example, the tiddler Caruso - Ave Maria points to an online audio recording hosted on http://archive.org:
{{Caruso - Ave Maria}}Affichera ceci :
S'il y a un ModuleSauvegarde qui l'accepte, TiddlyWiki déclenche automatiquement celle du document courant au clic sur valide ou sur supprime lors de la saisie d'un tiddler.
Vous apercevrez une notification jaune en haut à droite de la fenêtre confirmant qu'une sauvegarde automatique à eu lieu.
La sauvegarde automatique peut être activée ou non via l'onglet Paramétrage du panneau de contrôle . En arrière plan, elle est contrôlé par le tiddler de paramétrage $:/config/AutoSave, qui doit avoir la valeur yes pour activer la sauvegarde automatique.
| purpose | find the titles that link to each input title |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | any non-system titles that contain hard links to the input titles |
Each input title is processed in turn. The corresponding tiddler's list of backlinks is generated, sorted alphabetically by title, and then dominantly appended to the operator's overall output.
[[HelloThere]backlinks[]]
[all[current]backlinks[]]
Base64 est une façon de représenter des données binaires telles que des images, comme une chaine de texte.
From Beaker Browser website:
Beaker is a Peer-to-Peer Web Browser, made for users to run applications independently of hosts. Using P2P Hypermedia, Beaker separates frontend apps from backend services, so that users are completely in control of their software and data. Read more.
Beaker is a fork of the open source Chromium browser (which is the core engine powering Google's Chrome browser).
Beaker adds the ability to host sites within the browser, and browse to those sites via the dat:// protocol. The extraordinary thing is that if you are running Beaker then you can also browse to sites hosted by other users, without needing any server in between.
Further, you can opt to host a site belonging to somebody else, forming part of a Bittorrent-like swarm of peers serving the content to other browsers. You can also fork a site, making your own copy that you can change as you need.
The main disadvantage is that mainstream browsers cannot use dat:// sites.
Most of the magic is accomplished by the underlying Dat protocol.
New in: 5.1.14 TiddlyWiki incorporates a special saver module permitting changes to be saved directly from Beaker browser. See Saving on Beaker Browser for instructions.
| purpose | find which input title precedes a specified one |
|---|---|
| input | a selection of titles |
| parameter | T = one of those titles |
| output | the title that immediately precedes T in the input |
If T is not present in the input, or is the first title there, then the output is empty.
These examples make use of the Days of the Week tiddler. The Thursday tiddler shows a further example.
[list[Days of the Week]before[Saturday]]
[list[Days of the Week]before[Monday]]
Here are the details of the beta releases of TiddlyWiki5. See TiddlyWiki5 Versioning for details of how releases are named.
Release 5.0.18-beta
Released 17 septembre 2014 at 21:10
See GitHub for detailed change history of this release
This is a minor release prior to the full release of TiddlyWiki on September 20th. The documentation has been cleaned up and improved (with more improvements to come).
File Layout of tiddlywiki.com
The layout of files on tiddlywiki.com has been adjusted to make it more logical. See the ticket for a discussion. You can see the source files that make up tiddlywiki.com at https://github.com/Jermolene/jermolene.github.com
Hackability Improvements
- Added first iteration of a
list-linksmacro (further improvements are planned) - Added support for importing
.markdownand.mdfiles - Extended
timelinemacro to support a subfilter
Bug Fixes
- Fixed problem with digits being classified as lower case letters for wiki link matching
- Fixed crash when sorting missing tiddlers by fields other than title
- Fixed problem with handling
.jpegfile extensions - Fixed problem with RadioWidget and missing tiddlers
- Fixed problem with dragging a partially selected link
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
Il existe deux manières de produire des éléments HTML de type citation en bloc avec TiddlyWiki, l'un pour du contenu qui pourra s'afficher sur plusieurs lignes, et l'autre pour du contenu qui ne devra s'afficher que sur une seule ligne.
Citation en bloc multi-lignes
La syntaxe pour les blocs multi-lignes est :
<<<
Ceci est un paragraphe de type citation en bloc
écrit en français
<<<
Affichera ceci :
Ceci est un paragraphe de type citation en bloc écrit en français
... Génération du HTML :
<blockquote class="tc-quote"><p>Ceci est un paragraphe de type citation en bloc écrit en français </p></blockquote>
Attribution
Une attribution peut-être ajoutée au bloc comme ceci, comme ceci :
<<<
Les ordinateurs sont des vélos pour nos neurones
<<< Steve Jobs
Affichera ceci :
Les ordinateurs sont des vélos pour nos neurones
Steve Jobs
... Génération du HTML :
<blockquote class="tc-quote"><p>Les ordinateurs sont des vélos pour nos neurones </p><cite>Steve Jobs</cite></blockquote>
Classes CSS
Les blocs peuvent hériter des propriétés de classes CSS:
<<<.myClass.another-class
Les systèmes d'exploitation sont des murs pour notre esprit
<<< Personne
Affichera ceci :
Les systèmes d'exploitation sont des murs pour notre esprit
Personne
... Génération du HTML :
<blockquote class="tc-quote myClass another-class"><p>Les systèmes d'exploitation sont des murs pour notre esprit </p><cite>Personne</cite></blockquote>
Bloc uniligne
La syntaxe des citations uniligne est une extension de la syntaxe des Listes avec WikiText. Par exemple :
> Bloc de citation uniligne
> Un autre bloc uniligne
Affichera ceci :
Bloc de citation uniligne
Un autre bloc uniligne
... Génération du HTML :
<blockquote><p>Bloc de citation uniligne</p><p>Un autre bloc uniligne</p></blockquote>
Vous pouvez agréger des blocs unilignes comme ceci :
> Un bloc de niveau 1
>> Un bloc de niveau 2
> Un autre bloc de niveau 1
">>Affichera :
Un bloc de niveau 1
Un bloc de niveau 2
Un autre bloc de niveau 1
Vous pouvez mixer les citations en bloc avec d'autres types de listes. Par exemple :
* Liste une
** Liste deux
**> Un bloc uniligne
**> Un autre bloc uniligne
* Liste trois
Affichera ceci :
- Liste une
- Liste deux
Un bloc uniligne
Un autre bloc uniligne
- Liste deux
- Liste trois
... Génération du HTML :
<ul><li>Liste une<ul><li>Liste deux<blockquote><p>Un bloc uniligne</p><p>Un autre bloc uniligne</p></blockquote></li></ul></li><li>Liste trois</li></ul>
Pour aller plus loin
- les blocs en HTML5
The Blog edition of TiddlyWiki contains tools to help publish static HTML blogs written in TiddlyWiki. It is currently designed for use under Node.js.
While documentation is being prepared, see https://github.com/Jermolene-blog/blog for an example of use.
TiddlyWiki est conçu pour fonctionner avec des navigateurs HTML5-compatibles.
Le tableau suivant récapitule les versions de navigateur qui sont connues pour fonctionner avec TiddlyWiki
| Navigateurs | Status |
|---|---|
| Internet Explorer | Version 10 et suivantes |
| Chrome | Toutes les récentes versions |
| Firefox | Toutes les récentes versions |
| Firefox for Android | Toutes les récentes versions |
| Safari | Version 6 et suivantes |
Introduction
The browse widget displays an HTML file browser button that allows the user to choose one or more files to import. It sends a WidgetMessage: tm-import-tiddlers carrying a JSON representation of the tiddlers imported from the files up through its parents. This message is usually handled by the NavigatorWidget which adds the tiddlers to the store and updates the story to display them.
Content and Attributes
The content of the <$browse> widget is ignored.
| Attribute | Description |
|---|---|
| multiple | Set to "multiple" to select multiple file upload |
| deserializer | New in: 5.1.15 Optional name of deserializer to be used (by default the deserializer is derived from the file extension or type) |
| tooltip | Optional tooltip text |
| message | Optional override of widget message to be generated. The parameter for the message will be the JavaScript object event.target.files |
On iPhone/iPad choosing the multiple option will remove the ability to take photographs/videos directly into TiddlyWiki.
e.g.
<$browse>renders as:
BT (née British Telecom) is the UK's largest telecommunications company. In 2007, Osmosoft was acquired by BT. JeremyRuston subsequently left BT in 2011.
En mai 2007, British Telecom a acquis Osmosoft, ma société de consultant. Acquérir une société avec un seul employé et un minuscule filet de revenu relevait d'une décision inhabituelle, Osmosoft ne détenant même pas la propriété intellectuelle de TiddlyWiki, puisque je l'avais transférée à UnaMesa pour assurer son avenir pour la communauté.
La motivation de British Telecom était de mieux comprendre les écosystèmes basés sur les communautés. Je rejoignis la société en tant que « Head of Open Source Innovation », responsable de la gouvernance open source, et fournissant des conseils et de l'expertise sur la manière de participer à des communautés open source.
Compile le wiki courant à partir des cibles spécifiées. Si aucune cible n'est spécifiée, toutes les cibles seront compilées.
--build <target> [<target> ...]Les cibles de compilation sont définies dans le fichier tiddlywiki.info du dossier associé au wiki.
Voir TiddlyWikiFolders pour des détails sur la définition de cibles de compilation.
TiddlyWiki5 can be used to build older 2.x.x versions of TiddlyWikiClassic from their constituent components. Doing so involves these features:
- The
tiddlywiki/classictoolsplugin, containing a deserializer module which allows tiddlers to be loaded from TiddlyWiki 2.x.x.recipefiles - The
stripcommentsformat for the ViewWidget, which strips single line JavaScript comments starting//# - The
stripTitlePrefix='yes'attribute of the FieldsWidget, which removes prefixes wrapped in curly braces from thetitleattribute- For example,
{tiddler}HelloTherewould be transformed toHelloThere
- For example,
Usage
TiddlyWikiClassic is built from the command line by running TiddlyWiki on Node.js. A typical usage would be:
node ../../tiddlywiki.js \
--verbose \
--load <path_to_recipe_file> \
--rendertiddler $:/core/templates/tiddlywiki2.template.html <path_to_write_index_file> text/plain \
|| exit 1| purpose | discard the last N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | all but the last N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]butlast[]]
[list[Days of the Week]butlast[2]]
A B C D E F G H I J K L M +[butlast[7]]
127.0.0.1
17 décembre 2014 à 21h12
Introduction
The button widget displays an HTML <button> element that can perform a combination of optional actions when clicked:
- Executing any ActionWidgets that are immediate children of the button widget
- Execute any integrated actions:
- Navigate to a specified tiddler
- Dispatch a user defined widget message
- Trigger a user defined popup
- Assign new text to a specified tiddler
The integrated actions are provided as a shortcut for invoking common actions. The same functionality is available via ActionWidgets, with the exception of the support for highlighting selected popups.
Content and Attributes
The content of the <$button> widget is displayed within the button.
| Attribute | Description |
|---|---|
| to | The title of the tiddler to navigate to |
| message | The name of the widget message to send when the button is clicked |
| param | The optional parameter to the message |
| set | A TextReference to which a new value will be assigned |
| setTo | The new value to assign to the TextReference identified in the set attribute |
| popup | Title of a state tiddler for a popup that is toggled when the button is clicked |
| aria-label | Optional Accessibility label |
| tooltip | Optional tooltip |
| class | An optional CSS class name to be assigned to the HTML element |
| style | An optional CSS style attribute to be assigned to the HTML element |
| selectedClass | An optional additional CSS class to be assigned if the popup is triggered or the tiddler specified in set already has the value specified in setTo |
| default | Default value if set tiddler is missing for testing against setTo to determine selectedClass |
Tip: Set class to tc-btn-invisible tc-tiddlylink to have a button look like an internal link.
La convention de casse Camel est formée à partir d'une phrase, dont on met en capital la première lettre de chaque mot et dont on supprime les espaces entre eux, formant ainsi un seul et unique mot. De nombreux wiki utilisent CamelCase pour marquer les phrases qui génèrent un lien de façon automatique.
Exemple : ExempleDeCamelCaseQuiGénèreUnLienVersUnNouveauTiddlerPortantCeNom
Le CSS est un format de texte brut standard employé pour définir le style de présentation d'éléments variés sur une page web.
The changecount macro returns the number of times the current tiddler has been created, stored or deleted during the current TiddlyWiki session.
If a tiddler is deleted and subsequently recreated, its changecount will go up by two.
Parameters
(none)
<<changecount>>The value will increase if you edit this tiddler and store it again, even without making any changes to its content.
To access the changecount of a different tiddler, use a $tiddler widget:
<$tiddler tiddler="Draft of 'New Tiddler'">
<<changecount>>
</$tiddler>The value shown will increase whenever you create, store or delete New Tiddler.
Introduction
Cette version résoud un certain nombre d'incohérences dans la manière dont les filtres sont gérés. Ces changements impliquent que les filtres préexistants peuvent nécessiter des mises à jour — en particulier ceux qui s'exercent potentiellement sur des tiddlers manquants ou shadow.
Changements à is et ajout de all
La plupart des opérateurs de filtres agissent en réagençant tout ou partie des titres source. Ceux qui ajoutent de nouvelles entrées qui ne faisaient pas partie de la liste sur laquelle ils agissent sont nommés sélecteurs. Avant la version 5.0.9-beta, quelques nouveaux opérateurs de filtres étaient incohérents dans leur manière de filtrer la liste source ou d'y ajouter de nouvelles entrées.
Les changements spécifiques sont les suivants :
- L'opérateur is se contente à présent de filtrer à partir de la liste de tiddlers déjà sélectionnée
- Le nouvel opérateur all agit comme sélecteur en remplaçant la liste en cours avec une combinaison de tidddlers issus des sources spécifiques suivantes :
- current pour le tiddler courant
- missing pour tous les tiddlers manquants
- orphans pour tous les tiddlers orphelins
- shadows pour tous les tiddlers shadow
- tiddlers pour tous les tidders non-shadow (comprenant à la fois les tiddlers système et non système)
Les sources de l'opérateur all peuvent être combinées à l'aide du caractère +. Par exemple, [all[shadows+tiddlers]] renvoie tous les tidders shadow ainsi que tous les tiddlers ordinaires.
Précédemment, il n'était pas rare d'avoir [is[shadow]] au début d'une chaîne de filtre pour sélectionner tous les tidders shadow. À partir de 5.0.9, au lieu de renvoyer tous les tiddlers shadow, cela renverra seulement les tiddlers ordinaires qui s'avèrent être aussi un tiddler shadow (par la grâce d'en avoir écrasé un). La solution consiste à utiliser le nouvel opérateur all. Par exemple, si l'on considère ce filtre tiré de 5.0.8 :
[is[shadow]!has[draft.of]tag[$:/tags/AdvancedSearch]] [!is[shadow]!has[draft.of]tag[$:/tags/AdvancedSearch]] +[tag[$:/tags/AdvancedSearch]]Avec 5.0.9, ce filtre a été changé en :
[all[shadows+tiddlers]tag[$:/tags/AdvancedSearch]!has[draft.of]]On remarque comment l'opérateur all permet d'effectuer des opérations sur des tiddlers à partir de combinaisons de sources.
Changements pour [is[current]]
Une conséquence de ces changements est que [is[current]] est à présent un pur filtre sur les tiddlers source ; du coup, si le tiddler courant est un tiddler manquant qui ne se trouve pas dans la liste source, [is[current]] renverra une liste vide.
Généralement, la solution consiste plutôt à utiliser [all[current]]. Ce n'est pas aussi naturel à lire, mais ça a le comportement attendu de retourner systématiquement le tiddler courant, qu'il se trouve ou non parmi les tiddlers sources.
Changements concernant title et field
Il y a des changements mineurs sur la façon dont fonctionnent les opérateurs title et field.
L'opérateur title est un sélecteur : il renvoie le titre spécifié, qu'il se trouve ou non dans la source courante. title est utilisé comme opérateur par défaut si aucun opérateur n'est spécifié.
L'opérateur field est un filtre : il se contente de retourner un sous-ensemble des tiddlers source. field est utilisé comme opérateur par défaut si l'opérateur fourni n'est pas défini (l'opérateur fourni est alors passé comme suffixe de l'opérateur field, de sorte que [description[Missing]] est équivalent à [field:description[Missing]]).
Introduction
The checkbox widget displays an HTML <input type="checkbox"> element that is dynamically bound to either:
- the presence or absence of a specified tag on a specified tiddler
- the value of a specified field of a specified tiddler
Content and Attributes
The content of the <$checkbox> widget is displayed within an HTML <label> element immediately after the checkbox itself. This means that clicking on the content will toggle the checkbox.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler to manipulate (defaults to the current tiddler) |
| tag | The name of the tag to which the checkbox is bound |
| invertTag | When set to yes, flips the tag binding logic so that the absence of the tag causes the checkbox to be checked |
| field | The name of the field to which the checkbox is bound |
| index | New in: 5.1.14 The index of the tiddler, a DataTiddler, to which the checkbox is bound |
| checked | The value of the field corresponding to the checkbox being checked |
| unchecked | The value of the field corresponding to the checkbox being unchecked |
| default | The default value to use if the field is not defined |
| class | The class that will be assigned to the label element |
| actions | New in: 5.1.14 A string containing ActionWidgets to be triggered when the checkbox is checked |
| uncheckactions | New in: 5.1.16 A string containing ActionWidgets to be triggered when the checkbox is unchecked |
Tag Mode
Using the checkbox widget in tag mode requires the tag attribute to specify the name of the tag. The tiddler attribute specifies the tiddler to target, defaulting to the current tiddler if not present.
This example creates a checkbox that flips the done tag on the current tiddler:
<$checkbox tag="done"> Is it done?</$checkbox>Affichera ceci :
Field Mode
Using the checkbox widget in field mode requires the field attribute to specify the name of the field. The checked and unchecked attributes specify the values to be assigned to the field to correspond to its checked and unchecked states respectively. The default attribute is used as a fallback value if the field is not defined.
This example creates a checkbox that is checked if the field status is equal to open and unchecked if the field is equal to closed. If the field is undefined then it defaults to closed, meaning that the checkbox will be unchecked if the status field is missing.
<$checkbox field="status" checked="open" unchecked="closed" default="closed"> Is it open?</$checkbox><br>''status:'' {{!!status}}Affichera ceci :
status:
Index Mode
To use the checkbox widget in index mode set the index attribute to the index of a DataTiddler. The checked and unchecked attributes specify the values to be assigned to the index and correspond to its checked and unchecked states respectively. The default attribute is used as a fallback value if the index is undefined.
The example below creates a checkbox that is checked if the index by the name of this tiddler in the tiddler ExampleData is equal to selected and unchecked if the index is an empty string. If the index is undefined then it defaults to an empty string, meaning the checkbox will be unchecked if the index is missing.
<$checkbox tiddler="ExampleData" index=<<currentTiddler>> checked="selected" unchecked="" default=""> Selected?</$checkbox>Affichera ceci :
actions Attribute
This example of using the actions attribute shows both the Action Set Field Widget and Action Send Message Widget to demonstrate two actions.
The Set Widget uses a filter value to set the value of variable tag. The Action Send Message Widget joins all the tags into one large tag. The Action Set Field Widget appends the tags as individual tags. In this example, the Field Mangler Widget is required for the Action Send Message Widget but not for Action Set Field Widget. Be aware that the action occurs whether you check or uncheck.
It is often necessary to use triple quotes with the actions attribute. Alternatively, the attribute can be assigned directly from a variable with actions=<<my-actions>>.
<$fieldmangler>
<$set filter="[[Features]] [[Encryption]] +[tags[]]" name="tag">
<$checkbox actions="""<$action-setfield $field="tags" $value=<<tag>> /><$action-sendmessage $message="tm-add-tag" $param=<<tag>> />""" field="checked" checked="YES" unchecked="NO" >
Add tags from tiddlers [[Features]] and [[Encryption]]
</$checkbox>
</$set>
</$fieldmangler>Affichera ceci :
Un bloc de code est délimité par trois caractères "accents graves" ``` (connus en anglais sous le nom de "backticks") :
Ceci est un paragraphe ordinaire. ``` Ce texte aura une chasse fixe et ne sera pas `formaté`. ```
- Remarques
- Pour être interprétés correctements, les trois backticks doivent être :
- précédés de deux retours à la ligne (pour terminer correctement le paragraphe précédent) ;
- au début de la ligne ;
- immédiatement suivis d'un retour à la ligne.
- Certains claviers traitent le backtick comme une touche morte, le rendant difficile à taper. L'astuce est de taper 3
`suivis d'un espace. Une autre méthode consiste à taper 6`d'affilée, puis de bouger le curseur en arrière trois fois pour taper ou coller le contenu du bloc.
Introduction
The codeblock widget renders text in <pre> and <code> blocks, causing it to be
displayed monospace. A language may optionally be specified using the
language attribute, however syntax highlighting will only be used if the
Highlight Plugin is installed.
Content and Attributes
The content of the <$codeblock> widget is ignored.
| Attribute | Description |
|---|---|
| code | Contents of the block to render as code |
| language | Programming language for syntax highlighting |
The language attribute accepts either:
- a Highlight.js language code (see https://highlightjs.org/static/demo/ for a list)
- a MIME type (eg,
text/htmlorimage/svg+xml)
Examples
Here is an example embedding the contents of a tiddler as a code block.
<$codeblock code={{$:/editions/tw5.com/macro-examples/say-hi}} />Affichera ceci :
\define sayhi(name:"Bugs Bunny" address:"Rabbit Hole Hill")
Salut, Je suis $name$ et je vis à $address$.
\end
A codeblock may also specify a language.
<$codeblock code="SELECT * FROM users WHERE deleted = false" language="sql" />Affichera ceci :
SELECT * FROM users WHERE deleted = falseThe colour (or color) macro returns the CSS value of one the colours in the current palette.
If no such entry exists in the current palette, the vanilla palette is used instead.
Parameters
- name
- The name of the palette entry, e.g.
page-background
<<colour code-border>><<colour foreground>><<colour page-background>><<colour sidebar-tab-background>><<colour tag-foreground>>Colour: <$edit-text tiddler='$:/_MyColour' tag='input' placeholder='(unset)' default=''/>
---
<$macrocall $name='colour-picker' actions="
<$action-setfield $tiddler='$:/_MyColour' $value=<<colour-picker-value>>/>
"/>Une palette de couleur est un tiddler data qui affecte une valeur de couleur CSS, comme yellow ou #fe0, à chacun des multiples noms de couleur, de cette façon :
page-background: #fe0
table-border: #ccc
...Plusieurs palettes font partie du noyau. le tiddler système $:/palette contient toujours le titre du tiddler en cours de la palette sélectionnée.
Pour récupérer la valeur du nom d'une couleur dans la palette courante, ex : à employer dans un tiddler stylesheet, faites appel à la macro colour :
<<colour page-background>>Les tiddlers palette tiddlers contiennent les champs suivants :
| Nom | Valeur |
|---|---|
| title | Débute typiquement par $:/ |
| type | application/x-tiddler-dictionary |
| tags | $:/tags/Palette |
| description | Affichée à l'exploration de la palette |
| text | name: value définition des couleurs |
Le CSV est un format de texte brut standard pour stocker des tableaux de données.
Chaque ligne d'une table est appelé un enregistrement (record) et n'occupe qu'une seule ligne.
Les colonnes sont appelées champs (field). Chaque champ d'une ligne est séparée du suivant par une virgule, et souvent encadré par des balises double-cote.
La macro csvtiddlers renvoie le contenu d'un tiddler dans ce format.
| purpose | select the titles of all the Node.js commands |
|---|---|
| input | ignored |
| parameter | none |
| output | the command words that can be given to TiddlyWiki on Node.js |
C'est ici que nous rassemblons les dernières productions les plus utiles en provenance de la communauté TiddlyWiki.
Les informations, articles, ressources et exemples les plus récents.
Code styles and auto format settings for IDEs
https://gitlab.com/bimlas/tw5-code-style-auto-format
Posted il y a 2 mois
Implementation of TiddlyWiki Coding Style Guidelines for different IDEs.
"TiddlyWiki Toolmap" by David Gifford
https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM
Posted il y a 3 mois
A topical index of known plugins, tutorials, themes, and other helpful tools for TiddlyWiki.
https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM
Some of the topics indexed so far include:
- Background images and background colors
- Breadcrumbs
- Business - examples
- CSS / Styles, general
- Calendars, dates and timelines
- Checklists
- Collaboration
- Color palettes
- Colors
- Data visualizations
- Developer / advanced tools
- Diplay tiddlers horizontally
- Dropdowns
- Educational
- External files
- Fields
- Fonts
- Fun and games
- Home and lifestyle
- IFrames and embedding media
- Image galleries, modals and lightboxes
- Images, icons, emojis
- Importing and exporting between TiddlyWiki files
- Includes scaffolding within a tiddler, dragging to reorder tiddlers, choosing the number of columns
- Interfacing with, importing and exporting to and from other formats
- Knowledge bases, dictionaries and glossaries
- Layout/UI
- Lightboxes
- Links, linking
- Lists and filters
- Maps and geography
- Masonry, scaffolding
- Math
- MindMapping
- Mobile tools
- Music and sound
- Navigation
- node.js
- Note-taking
- Open the "filter" tab
- Partially hidden tiddlers
- Personal websites (examples)
- Presentations and slideshows
- Printing
- Project management
- Publishing and hosting TiddlyWikis on the web
- Searching tools
- Security and backup tools
- Social media, sharing, comments
- Spreadsheets and math
- Startup
- Sticky titles
- Story and screenplay creation
- Table of contents
- Tables, charts and graphs (cf data visualizations)
- Tabs
- Tags, tagging
- Task management and productivity - to do lists
- Themes
- Understanding TiddlyWiki
- Writing and editing
Timimi
https://github.com/ibnishak/Timimi
Posted il y a 3 mois
Timimi is a Web Extension and executable for Firefox, Chrome and Chromium that allows it to save standalone TiddlyWiki files.
https://github.com/ibnishak/Timimi
This is an addon using native messaging, essentially handing over the contents to a webextension host (executable) which does the actual saving. Once installed, you can save the standalone TW from anywhere in your hard drive without any more interactions, like the original Tiddlyfox addon.
TW5-SingleExecutable by Jed Carty
https://github.com/OokTech/TW5-SingleExecutable
Posted il y a 10 mois
TiddlyWiki5 Packaged with the multi-user plugin in a single executable file.
https://github.com/OokTech/TW5-SingleExecutable
Tiddlywiki, node js, multiuser plugin - all packaged into a single file so user can just download the file and run it and not have to install anything else. Versions available for windows, osx, and linux.
Widdly by Opennota
https://github.com/opennota/widdly
Posted il y a 10 mois
A cross platform server application that can save tiddlers to a local database
https://github.com/opennota/widdly
a minimal self-hosted app, written in Go, that can serve as a backend for a personal TiddlyWiki.
"Dynamic Tables" by Jed Carty
http://ooktech.com/jed/ExampleWikis/DynamicTables/
Posted il y a 10 mois
Dynamic Tables is a set of macros that allow you to create tables where the rows are created from tiddlers and the columns from the tiddler fields, or where the columns are created from tiddlers and the rows from their fields. Individual cells can be edited on the fly. Row tables can be sorted by columns and column tables can be sorted by rows.
"ATWiki" by Lamusia Project
https://lamusia.github.io/#ATWiki
Posted il y a 13 mois
A desktop application for TiddlyWiki, running on Windows.
https://lamusia.github.io/#ATWiki
TiddlyWiki for Windows. A unique non-linear notebook for capturing, organising and sharing complex information.
"muritest" by Simon Huber
http://muritest.tiddlyspot.com
Posted il y a 13 mois
A terrific demo of drag and drop, pan and zoom, and other sophisticated touch effects. Based on the muuri plugin by Uwe Stuehler.
It's a frequent use case in TiddlyWiki that you will want to put the results of variables together with various bits of strings of text. This process in some programming languages is often referred to as "concatenating" text.
You might, for instance want to set up a template for your customer database, where links will automatically refer to additional contact information about your customer. Inside your tiddler, you might try something like this:
| ⚠ Warning: Don't do it this way! | [[Additional Info|<<currentTiddler>>-Contact]] |
But that won't work. If you try this, the link will be interpreted very literally, and will attempt to take you to:
<<currentTiddler>>-ContactThe solution is to use a macro to put the rendered value of <<currentTiddler>> together with the bit of additional text, -Contact.
Create a macro at the top of the tiddler like this:
\define linkup(link) [[Additional Info|$link$-Contact]]You might be tempted to invoke the new macro like this:
| ⚠ Warning: Don't do it this way! | <<linkup <<currentTiddler>> >> |
But if you do, you will find that <<currentTiddler>> doesn't get rendered, but instead gets passed literally.
Instead, you could use the MacroCallWidget widget, like this:
<$macrocall $name="linkup" link=<<currentTiddler>> />In this case, we passed the value of a variable directly to our macro. This is often a general way to go about this task. If you wanted to create more links based on other variables you could re-use the macro for each situation.
If, as in this case, the only variable you are using is currentTiddler then you could write a simple macro, like this:
\define linkup() [[Additional Info|$(currentTiddler)$-Contact]]Notice that in this case we don't pass an argument. Instead, we reference the variable using the special syntax $(variable)$. Since we don't pass an argument, we can invoke it without the <$macrocall> widget more simply, like this:
<<linkup>>
Ce sont les concepts qui sous-tendent TiddlyWiki. Comprendre comment ces idées s'articulent est la clé pour tirer le parti maximum de TiddlyWiki.
- Story River
- Palettes de couleurs
- Étiqueter par tag
- Champs date
- DefaultTiddlers
- Sélection de titre
- Liste de titres
- Images externes
- Liens dans un Tiddler
- Champs de tiddler
- Référence texte
- Tiddlers gabarits
- Keyboard Shortcut Tiddler
- Tiddlers système
- Tags système
- Tiddler courant
- Tiddlers shadow
- Ordre des tiddlers tagués
- Constructeurs de sélection
- Opérateurs de filtre
- Ajout prépondérant
- Filtre, Opérateurs
- Filtres
- Liens durs et souples
- Macros
- Messages
- Module, Type
- Modules
- Panneau d'information
- Permaliens
- Plugins
- Pragma
- Tiddlers
- Tiddlers Data
- Tiddlers Dictionnaire
- Tiddlers JSON
- Tiddlers Tag
- TiddlyWiki
- TiddlyWiki5
- Transclusion
- Variables
- Widgets
- Wiki
- WikiText
You can configure TiddlyWiki to start up using whatever individual or group of tiddlers you want using the default tiddlers mechanism.
In the control panel under the info tab is an input field labeled "Choose which tiddlers are displayed at startup". You can list whatever tiddlers you want to open at startup. Use double square brackets for titles containing spaces. For example:
FirstTiddler
SecondTiddler
[[Third Tiddler]]You can also use filter expressions to open more than one tiddler. For example:
[tag[HelloThere]]will open all tiddlers tagged as .
You can also use this technique to preserve open tiddlers at startup
The configuration tiddler $:/config/TiddlerInfo/Default contains the title of the tiddler containing the default tiddler info tab.
The default value is $:/core/ui/TiddlerInfo/Tools corresponding to the Tools tab. Other possible values are:
- $:/core/ui/TiddlerInfo/Tools
- $:/core/ui/TiddlerInfo/References
- $:/core/ui/TiddlerInfo/Tagging
- $:/core/ui/TiddlerInfo/List
- $:/core/ui/TiddlerInfo/Listed
- $:/core/ui/TiddlerInfo/Fields
- $:/core/ui/TiddlerInfo/Advanced
- $:/editions/tw5.com/TiddlerInfo/Sources
| purpose | filter the input by searching list fields for a value |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a field |
| parameter | S = a possible value to be found in list field F |
| output | those input tiddlers in which the list field F contains the value S |
! output | those input tiddlers in which the list field F does not contain the value S |
[[$:/StoryList]contains[HelloThere]]
Sample data for TableOfContentsMacro.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Utilisé dans les protocoles Internet pour spécifier le type d'interprétation à appliquer au contenu d'une ressource web.
Dans TiddlyWiki, le champ type contient le type d'interprétation à appliquer au contenu du champ principal text.
Liste des Types de contenu (ContentType) courants
| Groupe | Type | Contenu des champs type |
|---|---|---|
| Développeur | Éléments d'un Dictionnaire | application/x-tiddler-dictionary |
| code JavaScript | application/javascript | |
| Éléments JSON | application/json | |
| Feuille de style Statique | text/css | |
| Image | image GIF | image/gif |
| fichier au format icone ICO | image/x-icon | |
| image JPEG | image/jpeg | |
| image PDF | application/pdf | |
| image PNG | image/png | |
| image Structured Vector Graphics | image/svg+xml | |
| Texte | balisage HTML | text/html |
| Feuille de style Cascade | text/css | |
| Valeurs séparées par des virgules | text/csv | |
| Texte brut | text/plain | |
| TiddlyWiki 5 | text/vnd.tiddlywiki | |
| TiddlyWiki Classic | text/x-tiddlywiki |
The contrastcolour macro returns whichever of two given CSS colours is deemed to contrast best with another.
An example can be seen in the template tiddler for tag pills.
Parameters
- target
- The colour to contrast against (typically a background colour)
- fallbackTarget
- An alternative colour to contrast against. This is used when
targetis undefined or not a valid colour - colourA
- The first of the two colours to choose between
- colourB
- The second of the two colours to choose between
Nous accueillons les contributions au code et à la documentation de TiddlyWiki de plusieurs manières :
- SignalerBugs
- Aider à améliorer notre documentation
- Contribuer au code via GitHub
- Voir https://tiddlywiki.com/dev pour plus de détails
Il existe encore plusieurs façons d'aider TiddlyWiki.
Accord de Licence des Contributeurs
À l'instar d'autres projets OpenSource, TiddlyWiki5 a besoin que ses contributeurs signent un accord de licence pour leurs contributions. C'est un accord contractuel qui permet aux contributeurs de confirmer qu'ils sont propriétaires des droits d'auteur de leurs contributions, et qu'ils acceptent de les licencier à l'Association UnaMesa (l'entité juridique qui possède TiddlyWiki au nom de la communauté).
- Pour les licences individuelles : licenses/CLA-individuelle
- Pour les licences d'organisation : licenses/CLA-organisation
Comment signer la CLA
Proposez une contribution (PullRequest) sur GitHub en ajoutant à cla-individual.md ou cla-entity.md, votre nom suivi de la date au format (YYYY/MM/DD).
pas à pas
- Cliquez licenses/CLA-individuelle ou licenses/CLA-organisation
- Dans le document
cla-individual.mdou lecla-entity.mdcliquez sur l'icone dans le coin en haut à droite, ce qui créera une copie modifiable du projet, un fork, dans votre espace de propositions et vous permettra de modifier ses différents documents - Modifiez la licence en ajoutant votre nom en bas comme dans l'exemple, eg :
Jeremy Ruston, @Jermolene, 2011/11/22 - Validez par un PullRequest
Les documents de CLA utilisés pour ce projets ont été créés en utilisant les modèles du projet Harmony. "HA-CLA-I-LIST Version 1.0" pour la "CLA-individuelle" et "HA-CLA-E-LIST Version 1.0" pour la "CLA-organisation".
Remarque
- Au cas où vous ne soyez pas propriétaire des droits d'auteurs de toutes vos propositions !
Veuillez le mentionner clairement, ou nous vous considérerons comme le détenteur légal des droits d'auteur de la contribution ! Aussi, veuillez fournir les liens et informations additionnelles décrivant sous quelle licence le reste du code est diffusé.
Contributing to TiddlyWiki5
Nous accueillons les contributions au code et à la documentation de TiddlyWiki de plusieurs manières :
- SignalerBugs
- Aider à améliorer notre documentation
- Contribuer au code via GitHub
- Voir https://tiddlywiki.com/dev pour plus de détails
Il existe encore plusieurs façons d'aider TiddlyWiki.
Accord de Licence des Contributeurs
À l'instar d'autres projets OpenSource, TiddlyWiki5 a besoin que ses contributeurs signent un accord de licence pour leurs contributions. C'est un accord contractuel qui permet aux contributeurs de confirmer qu'ils sont propriétaires des droits d'auteur de leurs contributions, et qu'ils acceptent de les licencier à l'Association UnaMesa (l'entité juridique qui possède TiddlyWiki au nom de la communauté).
- Pour les licences individuelles : licenses/CLA-individuelle
- Pour les licences d'organisation : licenses/CLA-organisation
Comment signer la CLA
Proposez une contribution (PullRequest) sur GitHub en ajoutant à cla-individual.md ou cla-entity.md, votre nom suivi de la date au format (YYYY/MM/DD).
pas à pas
- Cliquez licenses/CLA-individuelle ou licenses/CLA-organisation
- Dans le document
cla-individual.mdou lecla-entity.mdcliquez sur l'icone dans le coin en haut à droite, ce qui créera une copie modifiable du projet, un fork, dans votre espace de propositions et vous permettra de modifier ses différents documents - Modifiez la licence en ajoutant votre nom en bas comme dans l'exemple, eg :
Jeremy Ruston, @Jermolene, 2011/11/22 - Validez par un PullRequest
Les documents de CLA utilisés pour ce projets ont été créés en utilisant les modèles du projet Harmony. "HA-CLA-I-LIST Version 1.0" pour la "CLA-individuelle" et "HA-CLA-E-LIST Version 1.0" pour la "CLA-organisation".
Remarque
- Au cas où vous ne soyez pas propriétaire des droits d'auteurs de toutes vos propositions !
Veuillez le mentionner clairement, ou nous vous considérerons comme le détenteur légal des droits d'auteur de la contribution ! Aussi, veuillez fournir les liens et informations additionnelles décrivant sous quelle licence le reste du code est diffusé.
This file was automatically generated by TiddlyWiki5
Like other OpenSource projects, TiddlyWiki5 needs a signed contributor license agreement from individual contributors. This is a legal agreement that allows contributors to assert that they own the copyright of their contribution, and that they agree to license it to the UnaMesa Association (the legal entity that owns TiddlyWiki on behalf of the community).
- For individuals use: licenses/CLA-individual
- For entities use: licenses/CLA-entity
Les personnes ci-dessous ont généreusement donné de leur temps pour contribuer au développement de TiddlyWiki:
- Jeremy Ruston (@Jermolene)
- Dave Gifford (@giffmex)
- Bram Chen (@BramChen)
- Mario Pietsch (@pmario)
- Xavier Cazin (@xcazin)
- Eric Shulman (@ericshulman)
- Stephan Hradek (@Skeeve)
- BuggyJef (@buggyj)
- Nathan Cain (@natecain)
- Ton Gerner (@gernert)
- Devin Weaver (@sukima)
- João Bolila (@jbolila)
- David Johnston (@Brennall)
- David Jade (@davidjade)
- Bob Robison (@grayeul)
- @nameanyone
- Maurizio Pollio (@mpollio)
- Ogoshi Masayuki (@ogoshima)
- Chris Sugden (@csugden)
- @asampal
- Bow Yi Jang (@Eucaly)
- Mal Gamble (@malgam)
- Michael Fogleman (@mwfogleman)
- Daniel Barrett (@shendaras)
- Simon Baird (@simonbaird)
- James Anderson (@welford)
- Jon Lister (@jayfresh)
- @TheDiveO
- Danielo Rodríguez (@danielo515)
- @willover
- @slotik
- Irene Knapp (@IreneKnapp)
- Brian Shaver (@shakerlxxv)
- Tobi Beer (@tobibeer)
- Craig Cook (@BoyCook)
The copy-to-clipboard macro displays a button that copies specified text to the clipboard. A notification is displayed if the operation is successful; some browsers do not permit the operation.
Parameters
- src
- The text to be copied to the clipboard
- class
- Optional CSS classes to be assigned to the button (defaults to
tc-btn-invisible) - style
- Optional CSS styles to be assigned to the button
<<copy-to-clipboard "Mary had a little lamb">><$macrocall $name="copy-to-clipboard" src={{$:/SiteTitle}}/>Vous pouvez copier un tiddler particulier d'un fichier TiddlyWiki à un autre en glissant un vers le tiddler d'une fenêtre du navigateur à une autre.
The following macros are built into TiddlyWiki's core:
- changecount
- colour
- contrastcolour
- csvtiddlers
- datauri
- dumpvariables
- jsontiddlers
- lingo
- list-links
- makedatauri
- now
- qualify
- resolvepath
- Stylesheet Macros
- Macros Tables des matières
- tabs
- tag
- timeline
- version
- colour-picker
- copy-to-clipboard
- image-picker
- jsontiddler
- list-links-draggable
- list-tagged-draggable
- tag-picker
- tag-pill
- thumbnail
- tree
Les variables suivantes sont intégrées dans le noyau de TiddlyWiki :
- currentTiddler
- storyTiddler
- transclusion
- actionTiddler Variable
- modifier Variable
- namespace
- tv-history-list Variable
- tv-show-missing-links Variable
- tv-story-list Variable
- tv-tiddler-preview
Le noyau utilise aussi diverses configurations de variables et macros si vous les définissez :
| purpose | count the number of entries in a list |
|---|---|
| input | a selection of titles |
| output | a new list containing the number of items in the input list as a decimal string |
The number of the entries in the input list is counted and a decimal representation returned as a single string.
Introduction
The count widget displays the number of unique items in the output of specified filter expressions.
Content and Attributes
The content of the <$count> widget is ignored.
| Attribute | Description |
|---|---|
| filter | The filter expression to count |
Example
There are <$count filter="[tag[Examples]]"/> tiddlers tagged with ExamplesAffichera ceci :
There are 7 tiddlers tagged with Examples
Pour créer un format d'export personnalisé qui exporte les tiddlers comme du contenu textuel brut :
- Créer un tiddler avec les champs suivant :
- tags: $:/tags/Exporter
- description: Description de l'export
- extension: l'extension fichier par défaut pour ce format d'export (incluant le point ; par exemple
.tid)
- Intégrer le contenu suivant :
\define renderContent()
{{{ $(exportFilter)$ ||$:/core/templates/plain-text-tiddler}}}
\end
<<renderContent>>La variable exportFilter contient un filtre définissant quels tiddlers seront exportés.
By default, TiddlyWiki displays a blank screen while it is loading. You can add a special "splash screen" that is displayed while the wiki loads.
Larger TiddlyWiki files and those loaded over a slow network connection may take a little time to load. Once fully loaded, performance improves, because everything is now running entirely within the browser. Using a splash screen ensures people know the loading process is taking place, reducing the chance they will leave the page.
In order for the splash screen to be displayed before TiddlyWiki is initialised it is embedded as static HTML/CSS within the TiddlyWiki HTML file. This is done with the SystemTag: $:/tags/RawMarkupWikified/TopBody.
In order to remove the splash screen when the wiki has finished loading, the HTML should be wrapped in a container with the special class tc-remove-when-wiki-loaded. Any DOM elements with this class are automatically deleted by the core once the wiki has loaded.
Here's an example of a simple splash screen that just displays the text Loading. To use it, copy the text into a new tiddler, give it the type "text/plain" and the tag "$:/tags/RawMarkupWikified/TopBody":
<div class="tc-remove-when-wiki-loaded">
Loading...
</div>If the tiddler is given the WikiText type text/vnd.tiddlywiki then the contents are wikified as the file is saved, allowing transclusion etc. For example, here's an example that quotes the site title in the loading message. To use it, copy the text into a new tiddler, give it the type "text/vnd.tiddlywiki" and the tag "$:/tags/RawMarkupWikified/TopBody":
\rules only filteredtranscludeinline transcludeinline
<div class="tc-remove-when-wiki-loaded">
Please wait while {{$:/SiteTitle}} is loading
</div>The \rules directive is used to limit the wikitext syntax that is recognised to the two forms of inline transclusion. This avoids accidental wikification of tiddler content.
There is a more complex example splash screen using CSS animations and images configured in this wiki: see $:/SplashScreen
Créer des tiddlers
Vous créez un tiddler soit en cliquant sur le bouton du menu latéral, soit en cliquant sur un lien vers un tiddler absent. Les liens vers les tiddlers absents sont affichés en italique bleu.
Voir aussi :
Modifier des tiddlers
Pour modifier un tiddler existant, cliquez sur le bouton en haut et à droit du tiddler.
Mode ébauche
Quand vous créez un nouveau tiddler ou modifiez un existant, le tiddler passe en mode ébauche. Ce qui propose un panneau de contrôle pour apporter différents types de modifications. Il a plusieurs parties, de bas en haut :
- Le champ titre - pour modifier le titre du tiddler
- Le sélecteur de tags - pour ajouter ou supprimer des tags. Lors de la saisie d'un tag, une liste déroulante affiche les tags correspondant sous forme de complétions. Vous pouvez choisir dans cette liste ou créer un tag entièrement nouveau. Puis cliquez sur le bouton ajouter pour ajouter le tag au tiddler. Chaque tag est affiché sous forme d'une pilule colorée. Cliquez le "×" d'un pilule pour supprimer le tag
- La zone de texte - pour modifier le contenu principal du tiddler. Cliquez sur le bouton afficher la prévisualiation pour visualiser l'apparence des modifications
- Le sélecteur de type - pour afficher vos tiddlers dans un format spécial, comme une image. Voir ContentType pour la liste des options. Le choix par défaut est
text/vnd.tiddlywiki, qui indique que le tiddler contient du WikiTexte - Le sélecteur de champ - pour ajouter ou supprimer des champs du tiddler. Par exemple, si vous modifiez un tiddler utilisé comme tag par d'autres tiddlers, vous pouvez ajouter un champ ''list'' pour modifier l'ordre dans lequel ces tiddlers seront listé
Confirmer, annuler ou supprimer
Quand vous avez terminé les modifications, cliquez sur le bouton en haut et à droite du tiddler :
- Le bouton confirmer () mémorise vos modifications dans le tiddler et quitte le mode ébauche. Si votre wiki est configuré en AutoSave, vos modifications seront enregistrées de façon permanente. Autrement elles sont mémorisées temporairement dans votre navigateur web, et vous les perdrez si vous fermez votre page TiddlyWiki sans avoir cliqué sur le bouton principal pour Enregistrer dans le menu latéral.
- Le bouton annuler () ignore vos modifications (après demande de confirmation) et quitte le mode ébauche.
- Le bouton supprimer () supprime tout le tiddler (après demande de confirmation).
Introduction
Les tiddlers journaux sont des tiddlers dont le titre est composé d'une date et/ou d'une heure. Ils sont très utiles à l'enregistrement d'informations horodatées.
Vous pouvez ajouter des tags à votre tiddler journal pour le relier à d'autres tiddlers ce qui aidera à établir des relations entre les éléments d'information.
Par exemple, vous pourriez utiliser un tiddler journal appelé 10 Octobre 2014 pour enregistrer les idées et les informations capturées en ce jour particulier. Les tags Shopping et Londres mentionnant ce qui concerne le shopping à Londres.
Création d'un tiddler journal
La façon la plus simple de créer un tiddler journal est un clic sur le bouton nouveau journal dans l'onglet Outils du menu latéral. Si vous utilisez souvent le bouton, cliquez sur la case à cocher proche ce qui le placera juste au dessus de la zone de recherche.
Le bouton nouveau journal génère un journal correspondant à un tiddler vierge avec un tag Journal et un titre mentionnant la date du jour. Si un tiddler journal avec cette date existe déjà, il sera ouvert pour modification.
Création d'un tiddler journal tagué
Une suite d'actions courante sera la création (ou la réouverture) d'un tiddler journal du jour tagué avec le titre d'un autre tiddler. Cela pourra être effectué par le bouton nouveau journal ici de la barre d'outil du tiddler autre. Vous trouverez ce bouton dans l'onglet Outils du panneau d'information du tiddler.
Par exemple, lors de la révision d'un tiddler appelé Oxford Street , vous pourriez vous rendre compte de sa pertinence pour la préparation de votre tournée des magasins. Cliquer sur le bouton nouveau journal, ici dans le tiddler Oxford Street pour générer une entrée du journal étiquetée du tag Oxford Street.
Personnalisation des tiddlers journaux
Pour régler la façon dont les nouvelles entrées des journaux sont créés, rendez-vous à l'onglet Fondamentaux sous Info dans le panneau de contrôle:
- Gabarit pour les titres des tiddlers journaux spécifie la façon dont ces tiddlers seront nommés, par une chaine de format date. Le réglage par défaut sur
DDth MMM YYYYpermet aux nouvelles entrées d'avoir des titres de la forme "10 Octobre 2014" - Tags pour les nouveaux tiddlers journaux spécifie les tags que contiendront automatiquement les nouveaux journaux. Par exemple:
Journal [[Vacances d'été]]
Astuce: si vous souhaitez créer un tiddler journal différent à chaque fois que vous cliquerez sur nouveau journal (et ce plusieurs fois dans la même journée), vous pourriez inclure l'heure dans le format du titre, par exemple de cette façon AAAA-0MM-0DD au 0hhh0mm'0ss''.
Une autre astuce utile est d'inclure $(currentTiddler)$ quelque part dans le format du titre. Ainsi, si vous cliquez sur nouveau journal ici dans plusieurs tiddlers différents, les titres de chacun de ces tiddlers feront partie du nom des entrées de journal qui en résultera.
Cet exemple montre comment créer un déroulé imbriqué avec un tiddler indépendant du déroulé principal.
Voilà le code :
<$navigator story="MySubStoryList" history="MySubHistoryList">
Cliquez sur ce lien pour commencer: HelloThere
<$list filter="[list[MySubStoryList]]" history="MySubHistoryList">
<div>
! <$button message="tm-close-tiddler" class="tc-btn-invisible">{{$:/core/images/close-button}}</$button> <$view field="title"/>
<$transclude/>
</div>
</$list>
</$navigator>Notez comment vous pouvez ouvrir le tiddler Bienvenue dans un déroulé imbriqué en cliquant sur le lien suivant. Les liens du déroulé imbriqué s'ouvre indépendament du déroulé principal.
Cliquez sur ce lien pour commencer : Bienvenue
The csvtiddlers macro returns the fields of a selection of tiddlers in CSV form, with one record (row) per tiddler.
An example can be seen in the template tiddler for CSV exports.
Parameters
- filter
- A filter selecting which tiddlers to include
- format
- Reserved for future extension. Should be set to
quoted-comma-sep
Le tiddler courant fournit le contexte dans lequel plusieurs aspects de Wikitext sont interprétés.
Par exemple, {{!!title}} se réfère à la valeur du champ title du tiddler devenu courant, quel que soit-il. Cette technique peut être utilisée pour créer des tiddlers gabarit d'usage général.
Le titre du tiddler courant peut toujours être trouvé dans la variable currentTiddler.
Les deux façons les plus communes de modifier le tiddler courant sont :
Le tiddler courant n'est cependant pas souvent le même que le tiddler en cours d'affichage ou d'édition.
La variable currentTiddler contient le titre du tiddler en cours.
Plusieurs aspects de WikiText ont ce tiddler en contexte. Comme résultat, dans un widget $list ou via un tiddler gabarit, il n'est pas souvent nécessaire de spécifier explicitement le titre du tiddler.
Comparer avec storyTiddler.
Les exemples suivants ont une signification identique :
<$view field=title/><$view tiddler=<<currentTiddler>> field=title/>Cet exemple montre comment le widget $list modifie le tiddler en cours :
<ol>
<$list filter="[prefix[J]]">
<li><<currentTiddler>></li>
</$list>
</ol>Attribute: data-tags
New in: 5.1.16
The TiddlyWiki core adds several attributes to the rendered content. These make it possible to apply custom styles to tiddlers.
For example this tiddler is tagged: and so the attribute looks like this:
data-tags="[[How to apply custom styles]] example-test"Important: Tiddler tags are not sorted so the order in the rendered output may be different!
Examples
The following CSS is defined in Custom data-styles and creates a pink border for all tiddlers (including this one) tagged with example-test.
[data-tags*="example-test"] {
border: 2px solid pink;
}Styling Stylesheets
So to display tiddlers tagged: data-tags-styles in a decent way we can use the following code. (I could have used: $:/tags/Stylesheet, but that would affect all stylesheets in this wiki, which is not intended. amt ;)
Important: Don't forget to also specify .tc-tiddler-body or the whole tiddler, including the title, will be changed! see: Custom data-styles
[data-tags*="data-tags-styles"] .tc-tiddler-body {
display: block;
padding: 14px;
margin-top: 1em;
margin-bottom: 1em;
word-break: normal;
word-wrap: break-word;
white-space: pre-wrap;
background-color: #f5f5f5;
border: 1px solid #cccccc;
padding: 0 3px 2px;
border-radius: 3px;
font-family: Monaco, Consolas, "Lucida Console", "DejaVu Sans Mono", monospace;
}Hard Linebreaks
This mechanism may be handy for users who want to write prose text! See: Hard Linebreaks with CSS
More Possibilities
- [attr]
- Represents an element with an attribute name of attr.
- [attr="value"]
- Represents an element with an attribute name of attr and whose value is exactly "value".
- [attr~="value"]
- Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
- [attr|="value"]
- Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
- [attr^="value"]
- Represents an element with an attribute name of attr and whose first value is prefixed by "value".
- [attr$="value"]
- Represents an element with an attribute name of attr and whose last value is suffixed by "value".
- [attr*="value"]
- Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
- [attr "operator value" i]
- Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
Learn more at: Attribute selectors - CSS or CSS-Specification
Attribute: data-tiddler-title
New in: 5.1.16
The TiddlyWiki core adds several attributes to the rendered content. With those attributes it's possible to apply custom styles to the tiddler content.
For example this tiddler is named: "Custom styles by data-tiddler-title" so the attribute looks like this:
data-tiddler-title="Custom styles by title"Examples
The following CSS is defined in Custom data-styles and creates a blue border for exactly this tiddler.
[data-tiddler-title="Custom styles by title"] {
border: 1px solid blue;
}To create a green border for every tiddler that starts with $:/ aka system tiddlers, you'd need to use CSS like so: (not applied here but you can experiment with it! )
[data-tiddler-title^="$:/"] {
border: 1px solid green;
}More Possibilities
- [attr]
- Represents an element with an attribute name of attr.
- [attr="value"]
- Represents an element with an attribute name of attr and whose value is exactly "value".
- [attr~="value"]
- Represents an element with an attribute name of attr whose value is a whitespace-separated list of words, one of which is exactly "value".
- [attr|="value"]
- Represents an element with an attribute name of attr. Its value can be exactly “value” or can begin with “value” immediately followed by “-” (U+002D). It can be used for language subcode matches.
- [attr^="value"]
- Represents an element with an attribute name of attr and whose first value is prefixed by "value".
- [attr$="value"]
- Represents an element with an attribute name of attr and whose last value is suffixed by "value".
- [attr*="value"]
- Represents an element with an attribute name of attr and whose value contains at least one occurrence of string "value" as substring.
- [attr "operator value" i]
- Adding an i (or I) before the closing bracket causes the value to be compared case-insensitively (for characters within the ASCII range).
Learn more at: Attribute selectors - CSS or CSS-Specification
Tiddler Field: class New in: 5.1.16
The tag manager allows us to set a tiddler color field, that is used to define the "tag-pill" colour. Since: New in: 5.1.16 we can define a class field, that is directly inserted into the ViewTemplate and it can be used for styling:
title: anyName
tags: $:/tags/Stylesheet
class: myClass
Every tiddler, that has a class field can be styled that way!
.myClass {
border: 2px solid blue;
}
Learn more at: How to apply custom styles
Par défaut les résultats de la recherche du menu latéral sont affichés comme une simple liste de titres de tiddler. Ce résultat de recherche peut être personnalisé en ajoutant des plugins de visualisation qui les montreront de différentes façons. (les onglets sont affichés automatiquement si un résultat de recherche additionnel est détecté).
Les visualisations des résultats de recherche sont mémorisés dans les tiddlers étiquetés $:/tags/SearchResults. La liste de résultats de recherche par défaut est implémentée dans le tiddler système $:/core/ui/DefaultSearchResultList.
Pour créer un nouvel affichage de liste de recherche :
- Créez un nouveau tiddler étiqueté $:/tags/SearchResults
- Utilise la variable widget searchTiddler pour accéder au titre de chaque tiddler contenant les termes de la recherche en cours
Si vous voulez faire du nouvel affichage celui du résultat de recherche par défaut, créez un tiddler appelé $:/config/SearchResults/Default contenant le titre de cet affichage.
Voici un exemple d'affichage montrant les résultats dans l'ordre chronologique inverse :
\define searchResults()
<$set name="resultCount" value="""<$count filter="[!is[system]search{$(searchTiddler)$}]"/>""">
{{$:/language/Search/Matches}}
</$set>
<<timeline subfilter:"!is[system]search{$(searchTiddler)$}">>
\end
<<searchResults>>By default, a TiddlyWiki on Node.js instance using a wiki folder will create new tiddler files by using the sanitised and disambiguated title as filename.
This can be customised by creating a tiddler $:/config/FileSystemPaths containing one or more filter expressions, each on a line of its own. Newly created tiddlers are matched to each filter in turn, and the first output of the first filter to produce any output is taken as a logical path to be used for the tiddler file. Logical paths don't include the .tid extension, and they can use / or \ as directory separator (when generating the physical path, this is replaced by the correct separator for the platform TiddlyWiki is running on). If none of the filters matches, the logical path is simply the title with all occurences of / replaced by _ (for backwards compatibility).
In both cases, the characters <>:"\|?*^ are replaced by _ in order to guarantee that the resulting path is legal on all supported platforms.
Example
[is[system]removeprefix[$:/]addprefix[_system/]]
[tag[task]addprefix[mytasks/]]
[!has[draft.of]]This will store newly created system tiddlers in tiddlers/_system (after stripping the $:/ prefix), tiddlers tagged task in a subdirectory tiddlers/mytasks, and also create subdirectory structures for all other non-draft tiddlers.
Thus, $:/config/FileSystemPaths itself will end up in tiddlers/_system/config/FileSystemPaths.tid or tiddlers\_system\config\FileSystemPaths.tid, depending on the platform.
The final [!has[draft.of]] will match all remaining non-draft tiddlers. Because there was a match, any / or \ in the tiddler title is mapped to a path separator. Thus, some/thing/entirely/new will be saved to tiddlers/some/thing/entirely/new.tid (ie, the file new.tid in a directory called entirely).
Les tirets se font avec :
- deux caractères "moins"
--pour le tiret moyen ou semi-cadratin : – - trois caractères "moins"
---pour le tiret long ou cadratin : —
Une data URI est un moyen de stocker des données (telles qu'une image) d'une façon compatible avec les adresses utilisées par les pages web et les feuilles de styles pour accéder à des ressources externes.
La macro datauri peut être employée pour générer des data URIs via TiddlyWiki.
Un tiddler data est une mini-base de donnée contenue dans un tiddler.
Il existe deux formats standard :
D'autres formats de tiddler peuvent aussi être utilisés pour produire des blocs de données qui se comporteront comme des tiddlers data.
Utilisez TextReference pour rechercher une valeur par son nom. Par exemple, si un Tddler Dictionaire appelé JoursMois contient :
oct:31
nov:30
dec:31... alors {{JoursMois##nov}} retournera la valeur 30.
C'est aussi vrai si MonthDays est un Tiddler JSON avec le contenu suivant :
{"oct":31,"nov":30,"dec":31}Note: Il est actuellement possible de récupérer des données uniquement à partir des propriétés immédiates de l'objet racine d'un Tiddler JSON.
The datauri macro returns a data URI for the content of a tiddler.
It is often used in stylesheet tiddlers to reference things like inline images and fonts:
background: url(<<datauri "Motovun Jack.jpg">>);
The data URI is automatically base64-encoded in the case of a non-text tiddler.
Parameters
- title
- The title of a tiddler, such as an image
<style>
.jack {
background: url(<$macrocall $name="datauri" title="Motovun Jack.jpg" $output="text/plain"/>);
height: 300px;
}
</style>
<div class="jack"/>The example has to invoke datauri through the $macrocall widget. It needs to prevent the macro's output from being parsed as WikiText, as that would transform the data URI into a $link widget and break the example. If the example was in a CSS tiddler, you could simply write:
background: url(<<datauri "Motovun Jack.jpg">>);
Certains champs de tiddler servent à mémoriser dates et heures.
Les deux champs dates standard sont created et modified.
Les valeurs des champs date sont des chaine de 17-caractères :
- 4 chiffres pour l'année
- 2 chiffres pour le mois
- 2 chiffres pour le jour
- 2 chiffres pour l'heure
- 2 chiffres pour la minute
- 2 chiffres pour la seconde
- 3 chiffres pour la milliseconde
Pour éviter les problèmes découlant des différences de fuseau horaire, TiddlyWiki utilise toujours l'UTC.
À titre d'exemple, le champ created de ce tiddler a la valeur 20150117190213631.
Les dates peuvent être converties en d'autres formats d'affichage :
<$view field="created" format="date" template="DDD DDth MMM YYYY"/>Affichera ceci :
Samedi 17 janvier 2015
Le WidgetView accepte un attribut template qui permet de spécifier le format d'affichage des dates. A la chaine formatée se substituent les valeurs suivantes :
| Format | Valeur de Substitution |
|---|---|
DDD | Jour de la semaine en entier (ex, "Monday") |
ddd | Jour de la semaine abrégé (ex, "Mon") |
DD | N° du jour dans le mois |
0DD | Éventuel préfixe d'un zéro |
DDth | Ajout d'un suffixe |
WW | ISO-8601 n° de la semaine |
0WW | Éventuel préfixe d'un zéro |
MMM | Mois en entier (ex, "July") |
mmm | Mois abrégé (ex, "Jul") |
MM | N° du mois |
0MM | Éventuel préfixe d'un zéro |
YYYY | Année en entier |
YY | Année sur 2 chiffres |
wYYYY | Année complète avec numéro de la semaine |
wYY | Année abrégée avec numéro de la semaine |
hh | Heures |
0hh | Éventuel préfixe d'un zéro |
hh12 | Heures au format 12 heures |
0hh12 | Éventuel préfixe d'un zéro |
mm | Minutes |
0mm | Éventuel préfixe d'un zéro |
ss | Secondes |
0ss | Éventuel préfixe d'un zéro |
am/pm | Indicateur AM/PM en minuscule |
AM/PM | Indicateur AM/PM en majuscule |
TZD | Zone horaire |
\x | Utilisation du caractère d'échappement pour insérer des caractères sans interpréter le formatage |
Notez que tout autre texte sera affiché sans générer de modification, ce qui permet d'utiliser des virgules, les deux points ou tout séparateur utile.
Exemples
| Modèles | Résultats formatés |
|---|---|
DDth MMM wYYYY | 16 Février 2011 |
DDth MMM \M\M\M YYYY | 16 Février MMM 2011 |
DDth mmm hh:mm:ss | 16 Fév 2011 11:38:42 |
An interactive date picker plugin based on Pikaday. A demo can be found here: http://kixam.github.io/TW5-datePicker/.
datepicker is a TiddlyWiki plugin that allows you to use a widget much like EditTextWidget to pick a date, and optionaly a time. It shows a nice interactive mini-calendar when clicked, allows you to set a date format for display, and is compatible with core date fields such as
modifiedandcreated.
| purpose | filter the input by date |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a date field, defaulting to modified |
| parameter | D = a { positive | negative } number of days, defaulting to 0 |
| output | those input tiddlers in which field F is D days in the { future | past } or any time { before | after } that, including { past | future } |
! output | those input tiddlers in which field F is at least D days in the { future | past } |
Select tiddlers where a specified date field (default "modified") is within a specified date range. Time portion is ignored.
[days[-14]]
[!days:created[-800]]
The filter can be used to highlight new items in a list. For example:
<ul>
<$list filter="[tag[ReleaseNotes]!<currentTiddler>!sort[modified]]">
<li>
<$link><$view field="title"/></$link>
<$list filter="[<currentTiddler>days[-180]]"> @@color:red;^^new^^@@</$list>
<$list filter="[<currentTiddler>days[-500]!days[-180]]"> @@color:black;^^recent^^@@</$list>
</li>
</$list>
</ul>
Affichera ceci :
- Release 5.1.19 new
- Release 5.1.18 new
- Release 5.1.17 recent
- Release 5.1.16 recent
- Release 5.1.15 recent
- Release 5.1.14
- Release 5.1.13
- Release 5.1.12
- Release 5.1.11
- Release 5.1.10
- Release 5.1.9
- Release 5.1.8
- Release 5.1.3
- Release 5.1.5
- Release 5.1.6
- Release 5.1.7
- Release 5.1.4
- Release 5.1.2
- Release 5.1.1
- Release 5.1.0
| purpose | apply HTML decoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with HTML decoding applied |
"HTML decoding" means replacing HTML entities that represent special characters with that character:
&replaced with& replaced with<replaced with<>replaced with>"replaced with"
[[Title with < angle brackets >]] +[decodehtml[]]
[[Title with an & ampersand]] +[decodehtml[]]
| purpose | apply URI decoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with URI decoding applied |
[[Title%20with%20Space]] +[decodeuri[]]
[[Title%20with%20Space]] [[Another%20title%20with%20Space]] +[decodeuri[]]
| purpose | apply URI component decoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with URI component decoding applied |
See Mozilla Developer Network for details of the decodeURIComponent operation.
[[Title%20with%20Space]] +[decodeuricomponent[]]
[[Title%20with%20Space]] [[Another%20title%20with%20Space]] +[decodeuricomponent[]]
"Default tiddlers" refers to the list of tiddlers that is opened at startup in the browser if the address bar does not include a permalink).
At startup, the text of the system tiddler $:/DefaultTiddlers is retrieved and evaluated as a filter expression. The resulting list of titles is then inserted into the story river.
The control panel info/basics tab includes a text box for direct access to $:/DefaultTiddlers.
Voici les définitions des mots et phrases techniques employés dans cette documentation. (elles se distinguent des Concepts propres à TiddlyWiki).
- TiddlySpace
- Encodage PourCent (%)
- SingleFileApplication
- Type de contenu
- SinglePageApplication
- Stanford JavaScript Crypto Library
- Federatial
- TiddlyWikiClassic
- GuerillaWiki
- TiddlyWeb
- Keyboard Shortcut Descriptor
- TiddlyIE
- TiddlyFox
- TiddlyDesktop
- Base64
- CamelCase
- CSS
- CSV
- Data URI
- DOM
- Federatial Limited
- GitHub
- HTML
- JavaScript
- Jeremy Ruston
- Jermolene
- JSON
- MathML
- Node.js
- NW.js
- Open Source
- Quine
- URI
Les définitions utilisables en HTML sont créées en utilisant successivement ; et : :
; Terme à définir
: Définition du terme
; Un autre terme
: Une autre définition
Affichera ceci :
- Terme à définir
- Définition du terme
- Un autre terme
- Une autre définition
... Génération du HTML :
<dl><dt>Terme à définir</dt><dd>Définition du terme</dd><dt>Un autre terme</dt><dd>Une autre définition</dd></dl>
First of all: Keep calm!
In several fields, deprecation is the discouragement of use of some feature, design or practice; typically because it has been superseded or is no longer considered safe – but without completely removing it or prohibiting its use.
wikipedia
For TiddlyWiki it means, that you should not use this mechanism for new content anymore! AND you should update your existing content!
Deprecated features have a marker. see: Custom styles by tag
Tiddlers tagged $:/deprecated
Die deutsche Übersetzung von TiddlyWiki ist verfügbar unter:
- Dokumentation: https://tiddlywiki.com/languages/de-DE/index.html
- Leer: https://tiddlywiki.com/languages/de-DE/empty.html
Siehe auch: Deutsch (Österreich) Edition.
Die österreichische Übersetzung von TiddlyWiki ist verfügbar unter:
- Dokumentation: https://tiddlywiki.com/languages/de-AT/index.html
- Leer: https://tiddlywiki.com/languages/de-AT/empty.html
Siehe auch: Deutsch (Deutschland) Edition.
Les développeurs disposent de plusieurs ressources pour discuter et contribuer au développement de TiddlyWiki.
- tiddlywiki.com/dev la documentation officielle de développement
- TiddlyWikiDev group pour les discussions au sujet du développement de TiddlyWiki
- https://github.com/Jermolene/TiddlyWiki5 pour le code source et l'activité de développement
J'ai travaillé sur une nouvelle version de TiddlyWiki à partir de novembre 2011. En tant que programmeur, travailler à une « version 2.0 » de quelque chose que j'avais déjà écrit était une projet très séduisant. Cela signifiait que les besoins étaient bien compris, et je pouvais dès lors me concentrer sur l'architecture et ses évolutions nécessaires à la mise en œuvre des fonctionnalités désirées.
Un tiddler dictionnaire est un tiddler de données contenant une simple liste de paires nom/valeur.
Son type de contenu est application/x-tiddler-dictionary.
Le champ text contient une ou plusieurs lignes de la forme name: value.
Les palettes de couleurs, comme la palette par défault, Vanilla, sont des tiddlers dictionnaires.
Introduction
New in: 5.1.16 The diff text widget analyses the differences between a pair of source and destination text strings and displays the results as highlighted insertions and deletions (similar to the "track changes" function of a word processor). For example:
8 différences
Hey Jude, don't make it bad. Take a sad song and make it better. Remember tobe afraid. You were made to go out and get her. The minute you let her intounder your heart↩︎
skin. Then you can startbegin to make it better.Content and Attributes
Content
The content of the <$diff-text> widget is rendered immediately before the diffs. Within it, the variable diff-count is available, containing the number of differences found. If the widget has no content then it automatically transcludes the tiddler $:/language/Diffs/CountMessage.
In other words, these three invocations are all equivalent:
<$diff-text source={{FirstTiddler}} dest={{SecondTiddler}}> {{$:/language/Diffs/CountMessage}} </$diff-text> <$diff-text source={{FirstTiddler}} dest={{SecondTiddler}}> </$diff-text> <$diff-text source={{FirstTiddler}} dest={{SecondTiddler}}/>
Attributes
| Attribute | Description |
|---|---|
| source | The source text |
| dest | The destination text |
| cleanup | See below |
The cleanup attribute determines which optional post-processing should be applied to the diffs:
- none: no cleanup is performed
- semantic (default): rewrites the diffs for human readability
- efficient: rewrites the diffs to minimise the number of operations for subsequent processing
(Note that in many cases the results will be the same regardless of the cleanup option. See the docs of the underlying library for more details).
Examples
In this example we compare two texts:
<$edit-text tiddler="SampleTiddlerFirst"/>
<$edit-text tiddler="SampleTiddlerSecond"/>
<$diff-text source={{SampleTiddlerFirst}} dest={{SampleTiddlerSecond}}/>Affichera ceci :
4 différences
This is a test tiddler is called SampleTiddlerFirstSecond.Disabling Plugins
Plugins can be disabled by creating a tiddler titled $:/config/Plugins/Disabled/ concatenated with the plugin title, and setting its text to yes.
For example, to disable the plugin $:/plugins/tiddlywiki/highlight, the title would be:
$:/config/Plugins/Disabled/$:/plugins/tiddlywiki/highlightÀ moins que vous n'ayez déjà observé TiddlyWiki en action, nous pouvons vous garantir que vous n'avez jamais rien vu de semblable. TiddlyWiki est :
- un outil,
- une boîte à outils,
- une communauté,
- et une philosophie.
TiddlyWiki est un outil
TiddlyWiki est d'abord et avant tout un outil : un outil libre et gratuitement téléchargeable, qui sert à conserver et organiser du contenu, qu'il provienne du Web, de vos documents, ou de votre cerveau. Il s'agit d'un outil de prise de notes, d'annotation, de gestion de signets et de mémos, d'écriture, de gestion de projets et de listes de choses à faire, de collaboration, de blog, et d'édition.
Avec TiddlyWiki, vous créez ou collez du contenu dans des notes appelées tiddlers, puis vous connectez vos tiddlers avec des hyperliens et des tags. Vous pouvez ensuite retrouver vos notes facilement grâce à des fonctions comme des nuages de tags, des onglets latéraux, ou la fenêtre de recherche ultra rapide de TiddlyWiki. Vous pouvez même inclure dynamiquement le contenu d'un tiddler dans un autre — comme on assemble un jeu de construction — pour créer des articles, des listes, des présentations, etc.
TiddlyWiki est une boîte à outils
En plus d'être un outil multi-fonctions, TiddlyWiki est aussi une boîte à outils.
Là où d'autres produits de prises de notes commencent par vous attirer avec l'application de base, pour vous faire ensuite payer les fonctions réellement utiles, TiddlyWiki contient une collection de thèmes, palettes, plugins, widgets et macros, entièrement gratuits et en constante augmentation. Vous pouvez les combiner dans tous les sens pour corriger et remodeler votre TiddlyWiki à votre guise.
TiddlyWiki est aussi une communauté
Nous sommes une communauté d'utilisateurs et de développeurs qui s'aident mutuellement, imaginent de nouvelles façons de penser et d'organiser les connaissances, et créent de nouvelles solutions, afin d'adapter constamment TiddlyWiki aux besoins des utilisateurs. Les utilisateurs et les développeurs de TiddlyWiki partagent questions et conseils sur un forum Google dédié. Ils créent également des tutoriels, des adaptations et des plugins qui amélioreront votre expérience de TiddlyWiki. Rendez-vous à la section Communité de la table des matières pour plus de détails.
Enfin, TiddlyWiki est une philosophie
Prendre des notes et les organiser (et conserver toutes sortes de contenu) n'a d'intérêt que si vous êtes en mesure de les retrouver plus tard. Sinon, l'acte de prendre des notes n'est qu'une colossale perte de temps.
La philosophie de TiddlyWiki soutient que le meilleur moyen de prendre des notes consiste à les séparer en tiddlers, les plus petites unités sémantiques possibles. Un tiddler peut être une image, un lien sur une page web, la définition d'un terme, ou du code de personnalisation, comme une macro.
Ces tiddlers peuvent être ensuite combinés pour créer des unités plus longues : déroulés, articles, listes, galeries d'images, etc. Les fonctions de TiddlyWiki comme l'étiquetage, les références croisées et les filtres, sont conçues spécifiquement pour vous aider à associer et connecter les tiddlers de plusieurs manières, afin de faciliter la récupération de vos notes, voire vous aider à découvrir des relations inattendues entre vos tiddlers et l'information qu'ils contiennent.
Le DOM d'une page web est une représentation arborescente de son contenu, maintenue en interne pas le navigateur web pendant que l'utilisateur interagit avec ce contenu. Chaque intersection de l'arbre est appelée nœud (node).
Quand TiddlyWiki s'exécute dans un navigateur web, ses widgets interprètent les nœuds du DOM pour les afficher.
Quand TiddlyWiki est exécuté sur Node.js, il utilise un faux DOM pour simuler le comportement du navigateur.
Les macros suivantes sont utilisées tout au long de la documentation de TiddlyWiki. Leurs noms commencent par un point pour les séparer de celles que les utilisateurs ont l'habitude d'expérimenter.
Général
| Macro | Utilisé pour | Exemple |
|---|---|---|
| .def | l'occurrence d'un terme défini | widget |
| .em | mise en valeur mineur dans une phrase | non |
| .place | un emplacement à saisir par l'utilisateur | nomtag |
| .strong | mise en valeur majeur dans un tiddler | Important! |
| .word | la mention d'un mot ou une phrase ordinaire | "Salut à tous" |
Avis
| Macro | Utilisé pour | Exemple |
|---|---|---|
| .tip | Astuces & infos | |
| .warning | Avertissement |
Blocs
| Macro | Utilisé pour |
|---|---|
| .preamble | Un préambule qui se démarque du reste du tiddler |
Tiddlers et champs
| Macro | Utilisé pour | Exemple |
|---|---|---|
| .tid | un titre de tiddler | Exemple |
| .tag | un tag | Exemple |
| .field | un nom de champ | exemple |
| .value | la valeur d'un champ | exemple de valeur |
| .op | un opérateur de filtre | backlinks |
| .var | un nom de variable ou de macro | currentTiddler |
| .wid | un nom de widget | $list |
| .attr | un nom d'attribut | filter |
| .param | un nom de paramètre de macro | text |
Le carnaval des liens (cliquez pour essayer)
| Macro | Utilisé pour | Exemple |
|---|---|---|
| .link | un lien avec du WikiText | an |
| .clink | un lien en code | <$list> |
| .dlink | un lien vers l'occurrence d'un terme défini | widget |
| .dlink-ex | un lien externe vers une occurrence définie | Exemple |
| .flink | un lien vers un champ | list |
| .mlink | un lien vers une macro | qualify |
| .mlink2 | un lien vers une macro, avec cible spécifiée | foo |
| .olink | un lien vers un opérateur | prefix |
| .olink2 | un lien vers un opérateur, avec cible spécifiée | foo |
| .vlink | un lien vers une variable | currentTiddler |
| .vlink2 | un lien vers une variable, avec cible spécifiée | foo |
| .wlink | un lien vers un widget | $button |
| .wlink2 | un lien vers un widget, avec texte spécifié | foo |
Interface utilisateur
| Macro | Utilisé pour | Exemple |
|---|---|---|
| .key | une touche du clavier | Escape |
| .keycombo | une combinaison de touches | Ctrl+Enter |
Onglets
| Macro | Utilisé pour | Exemple |
|---|---|---|
| .sidebar-tab | le nom d'onglet du menu latéral | Plus |
| .more-tab | le nom d'une option de l'onglet Plus | Shadows |
| .info-tab | le nom d'un tiddler de l'onglet info | Champs |
| .controlpanel-tab | the name of a Control Panel tab | Paramétrage |
| .advancedsearch-tab | the name of an Advanced Search tab | Filtrer |
| .toc-tab | name of the tw5.com TOC tab | Sommaire |
| .example-tab | an example tab name | Notes |
Paramètres de .sidebar-tab (menu latéral)
| Open | Ouverts |
| Recent | Récents |
| Tools | Outils |
| More | Plus |
Paramètres de .more-tab (onglet plus)
| All | Tout |
| Recent | Récents |
| Tags | Tags |
| Missing | Manquants |
| Drafts | Brouillons |
| Orphans | Orphelins |
| Types | Types |
| System | Système |
| Shadows | Shadows |
Paramètres de .info-tab (panneau d'info)
| Tools | Outils |
| References | Références |
| Tagging | Étiquetage |
| List | Liste |
| Listed | Listé |
| Fields | Champs |
| Advanced | Avancé |
Paramètres de .controlpanel-tab (panneau de contrôle)
| Info | Info |
| Appearance | Apparence |
| Settings | Paramétrage |
| Saving | Sauvegarde |
| Plugins | Plugins |
Paramètres de .advancedsearch-tab (Recherche avancée)
| Standard | Standard |
| System | Système |
| Shadows | Shadows |
| Filter | Filtrer |
Boutons
| Macro | Utilisé pour | Exemple |
|---|---|---|
| .button | un bouton standard et son icone |
Paramètres de .button
Barre d'outils de Tiddler
| clone | |
| close | |
| close-others | |
| edit | |
| export-tiddler | |
| info | |
| more-tiddler-actions | |
| new-here | |
| new-journal-here | |
| permalink |
Barre d'outil du mode Edition
| cancel | |
| delete | |
| save |
Page des outils
| advanced-search | |
| close-all | |
| control-panel | |
| encryption | |
| export-page | |
| full-screen | |
| home | |
| import | |
| language | |
| more-page-actions | |
| new-journal | |
| new-tiddler | |
| permaview | |
| refresh | |
| save-wiki | |
| storyview | |
| tag-manager | |
| theme |
La documentation de TiddlyWiki tente de suivre les règles suivantes. L'objectif est de s'assurer que la documentation issue d'auteurs différents se lira de façon aussi homogène que possible.
- Adressez-vous au lecteur directement en disant "vous"
- Évitez la voix passive dans vos tutoriels et vos présentations
- Lorsque vous écrivez en Anglais, utilisez l'Anglais britannique de préférence à l'Anglais des États-Unis. En Français, si vous utilisez des expressions qui ne sont pas employées en France, reliez-les à un tiddler qui les replace dans leur contexte.
Voir aussi les règles pour les titres des tiddlers.
Les filtres manipulent des sélections de titres où aucun titre n'apparait plus d'une fois. En outre, ils ont souvent besoin d'ajouter tel ensemble à un autre.
Cet ajout s'effectue d'une façon telle que, si un titre vient à être dupliqué, la copie antérieure de ce titre est éliminé. Les titres ajoutés sont prépondérants.
Par exemple, si une sélection contient Andrew Becky Clara Daniel et que Andrew Barney Clara Daisy lui est ajouté, le résultat sera Becky Daniel Andrew Barney Clara Daisy.
Les Tiddlers qui ont un champ draft.of sont traités comme les ébauches en suspens des tiddlers indiqués dans le champ. Les tiddlers d'ébauche ont aussi un champ draft.title spécifiant le titre qui sera donné au tiddler après validation.
Plusieurs fonctionnalités fonctionnent de concert afin d'obtenir le comportement souhaité des tiddlers d'ébauche :
- Le ListWidget peut éventuellement afficher les tiddlers ébauche via un gabarit différent
- Le NavigatorWidget inclut des particularismes concernant les événements suivants :
tm-new-tiddlerpour créer un nouveau tiddler en mode ébauchetm-edit-tiddlerpour mettre un tiddler en mode éditiontm-cancel-tiddlerpour annuler un tiddler en mode éditiontm-save-tiddlerpour confirmer un tiddler d'ébauche
- Les tiddlers en cours d'ébauche sont exclus automatiquement du champ des recherche
TiddlyWiki uses drag and drop to power two separate features:
- Importing Tiddlers into TiddlyWiki
- Manipulating tiddlers within a TiddlyWiki
Tiddler manipulation via drag and drop is supported by the core user interface in the following contexts:
- Entries in the "Open" tab of the sidebar can be reordered by drag and drop; new tiddlers can be opened by dragging their titles into the list
- Entries within a tag pill dropdown can be reordered by drag and drop; new tiddlers can be assigned the tag by dragging their titles into the list
- Entries in the control panel "Appearance"/"Toolbars" tab can be reordered by drag and drop. (Less usefully, new entries can be added to the toolbars by dragging their titles into the list)
All tiddler links are draggable by default. They can be dragged within a browser window for manipulating tiddlers, or dragged to a different browser window to initiate an import operation
If you want to drag a link, first move it vertically, because horizontal movement is recognized by the browser as text selection.
Tag pills are also draggable, and are equivalent to simultaneously dragging all of the individual tiddlers carrying the tag.
Some common scenarios for drag and drop tiddler manipulation are available as reusable macros:
- list-links-draggable Macro for reordering the entries in a tiddler ListField
- list-tagged-draggable Macro for reordering the tiddlers that carry a specified tag
See DragAndDropMechanism for details of how to use the low level drag and drop primitives to build more complex interactions.
The standard HTML 5 drag and drop APIs used by TiddlyWiki are not generally available on mobile browsers on smartphones or tablets. The Mobile Drag And Drop Shim Plugin adds an open source library that implements partial support on many mobile browsers, including iOS and Android.
This tiddler discusses the internal mechanisms that are used to implement drag and drop features in TiddlyWiki. See Drag and Drop for a general description of the features.
The following widgets are concerned with drag and drop features:
- The DraggableWidget creates a draggable element that represents one or more tiddlers for dragging
- The ButtonWidget and LinkWidget incorporate the functionality of the DraggableWidget
- The DroppableWidget creates an area into which tiddlers can be dragged to trigger customisable actions
- The DropzoneWidget handles importing external tiddlers from files or by drag and drop from another browser window
The general sequence of a drag and drop operation is as follows:
- The user clicks down and drags the pointer on a draggable element such as the DraggableWidget, ButtonWidget or LinkWidget
- The draggable element moves with the mouse pointer until the click is released
- Moving the pointer over droppable elements such as the DroppableWidget displays a highlight indicating that the item can be dropped
- The configured actions are performed if the drag ends on a droppable element
The DraggableWidget creates a DOM element that can be dragged by the user. It only works on browsers that support drag and drop, which typically means desktop browsers, but there are workarounds.
The draggable element can be assigned a list of tiddlers that are used as the payload. If desired it can invoke actions when dragging starts and when it ends. See DragAndDropMechanism for an overview.
Content and Attributes
| Attribute | Description |
|---|---|
| tiddler | Optional title of the payload tiddler for the drag |
| filter | Optional filter defining the payload tiddlers for the drag |
| class | Optional CSS classes to assign to the draggable element. The class tc-draggable is added automatically, and the class tc-dragging is applied while the element is being dragged |
| tag | Optional tag to override the default "div" element |
| startactions | Optional action string that gets invoked when dragging starts |
| endactions | Optional action string that gets invoked when dragging ends |
Either or both of the tiddler and filter attributes must be specified in order for there to be a payload to drag.
The actionTiddler Variable is accessible in both startactions and endactions. It holds the payload tiddler(s) specified through the tiddler and filter attributes as a Title List using double square brackets to quote titles that include whitespace.
The LinkWidget incorporates the functionality of the DraggableWidget via the draggable attribute.
The droppable widget creates a DOM element onto which dragged items can be dropped by the user, triggering the specified actions. It only works on browsers that support drag and drop, which typically means desktop browsers, but there are workarounds.
See DragAndDropMechanism for an overview.
Content and Attributes
| Attribute | Description |
|---|---|
| actions | Actions to be performed when items are dropped |
| class | Optional CSS classes to assign to the draggable element. The class tc-droppable is added automatically, and the class tc-dragover is applied while an item is being dragged over the droppable element |
| tag | Optional tag to override the default of a "div" element when the widget is rendered in block mode, or a "span" element when it is rendered in inline mode |
Within the action string, there are two Variables generated by the DroppableWidget:
- The actionTiddler Variable contains the title of the item being dropped
- The modifier Variable contains the Modifier Key held while dragging (can be normal, ctrl, shift or ctrl-shift)
If multiple items are dropped then the actions are performed repeatedly, once for each dropped item.
Examples
This example displays a palette of icons. Dragging a tiddler onto one of the icons assigns that icon to the tiddler.
Similarly, this example shows a palette of colours. Dragging a tiddler onto one of the colours assigns that colour to be used for rendering the icon of the tiddler.
Introduction
The dropzone widget creates an area into which the user can drag files and other objects. It also supports pasting via the clipboard, although browser support is currently limited.
It sends a WidgetMessage: tm-import-tiddlers carrying a JSON representation of the tiddlers to be imported up through its parents. This message usually trapped by the NavigatorWidget which adds the tiddlers to the store and updates the story to display them.
Content and Attributes
| Attribute | Description |
|---|---|
| deserializer | New in: 5.1.15 Optional name of deserializer to be used (by default the deserializer is derived from the file extension) |
The list of available deserializers can be inspected by executing Object.keys($tw.Wiki.tiddlerDeserializerModules).sort().join("\n") in the browser JavaScript console.
The dropzone widget displays any contained content within the dropzone.
Display
The dropzone widget creates an HTML <div class="tc-dropzone"> to contain its content. During a drag operation the class tc-dragover is added. CSS is used to provide user feedback.
Data types supported
The following data transfer types are supported:
- text/vnd.tiddler - a list of tiddlers in JSON format (this format is generated by the LinkWidget)
- text/plain - plain text
- text/uri-list - a list of URIs as a single tiddler
La macro dumpvariables renvoie un tableau affichant les valeurs de toutes les variables et macros présentes à une position donnée de l'arbre widget.
Utile pour déboguer et explorer le fonctionnement interne de TiddlyWiki.
Les zones réservées sont remplacées par des valeurs de façon normale, mais en utilisant les valeurs par défaut pour tous les paramètres de macro.
Paramètres
(aucun)
<$set name="EXEMPLE" value="123..789">
<$set name="EXEMPLE2" value="456">
<<dumpvariables>>
</$set>
</$set>The Dynaview Plugin makes it possible to build user interfaces that dynamically respond to changes in the browser viewport via scrolling or zooming:
- CSS classes that allow rendering to be deferred until the output is scrolled into view
- CSS classes that allow the opacity of DOM elements to vary according to the current zoom level
See the demo at https://tiddlywiki.com/plugins/tiddlywiki/dynaview
| purpose | select one of each group of input titles by field |
|---|---|
| input | a selection of titles |
| suffix | optionally, list-item or value |
| parameter | F = the name of a field, defaulting to title |
| output | a selection containing the first input title encountered for each distinct value of field F |
Each input title is processed in turn. The value of field F in the corresponding tiddler is examined.
- each
- As long as the value of the field is unique (i.e. has not been encountered before), the title is appended to the output.
- each:list-item
- The value is treated as a title list. Each title in the list considered in turn. If it has not been encountered before, it is appended to the output.
- each:value
- As long as the title is unique it is appended to the output whether or not the corresponding tiddler exists.
If a tiddler does not contain field F, it is treated as if the value of the field were empty.
[each[color]]
[sort[title]each[type]]
[each:list-item[list]]
[[Non existing]] [[GettingStarted]] +[each:value[]]
+[each[]] below[[Non existing]] [[GettingStarted]] +[each[]]
+[each:value[]] aboveFor an example of using the each operator to generate a two-tier list of groups and members, see GroupedLists.
| purpose | select one of each group of input titles by date |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a date field, defaulting to modified |
| output | a selection containing the first input title encountered for each distinct value (ignoring times of day) of field F |
Each input title is processed in turn. The value of field F in the corresponding tiddler is examined, and as long as this indicates a date that has not been encountered before, the title is appended to the output.
If a tiddler doesn't contain field F, it contributes nothing to the output.
[eachday[created]]
For an example of using the eachday operator to generate a two-tier list of groups and members, see GroupedLists.
La edición española de TiddlyWiki se encuentra aquí:
- Documentación : https://tiddlywiki.com/languages/es-ES/index.html
- TiddlyWiki en blanco : https://tiddlywiki.com/languages/es-ES/empty.html
Introduction
The edit bitmap widget provides a user interface in the browser for editing bitmap tiddlers.
Content and Attributes
The content of the <$edit-bitmap> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | The tiddler to edit (defaults to the current tiddler) |
Configuration
The edit bitmap widget can be configured with these system tiddlers:
- $:/config/BitmapEditor/LineWidth determines the line width:
- $:/config/BitmapEditor/Colour determines the line color:
Michael Fogleman a rédigé un mode Emacs majeur appelé tid-mode, qui permet de modifier des fichiers TiddlyWiki .tid. C'est une variante du mode-texte qui utilise les modes mineurs org-struct et subword, et met à jour les modifications à chaque sauvegarde du fichier .tid .
Il a aussi écrit deux fonction aidant à l'utilisation de TiddlyWiki sur Emacs. La première ouvre un dossier de tiddlers dans Dired ; la seconde ouvre TiddlyWiki dans le navigateur.
(defun open-wiki ()
"Opens a TiddlyWiki directory in Dired."
(interactive)
(dired "~/Dropbox/wiki/tiddlers/"))(defun browse-wiki ()
"Opens TiddlyWiki in the browser."
(interactive)
(browse-url "127.0.0.1:8080/"))Cette fonction ultérieure nécessite un navigateur spécifique :
(setq browse-url-browser-function 'browse-url-generic
browse-url-generic-program "chromium")Vous pouvez créer un raccourci clavier vers chacune de ces fonctions avec la fonction global-set-key :
(global-set-key (kbd "C-c w") 'open-wiki)À ce jour, cela n'est pas intégré dans tid-mode.
Devin Weaver has written a Vim plugin at https://github.com/sukima/vim-tiddlywiki
It supports most of the TiddlyWiki syntax and includes a filetype plugin which will auto update the modified field.
| purpose | select the descriptions of the input editions |
|---|---|
| input | a selection of edition names |
| parameter | none |
| output | the description string of each edition in the input |
Each input title is processed in turn, ignoring any that is not the name of a TiddlyWiki edition.
- Note
- This operator is not available when TiddlyWiki is running in a web browser.
TiddlyWiki est publié sous différentes éditions adaptées à des objectifs spécifiques. Chacune est constituée des mêmes composants TiddlyWiki principaux, associés aux plugins nécessaires, à la documentation et au contenu d'exemple.
Vous pouvez mélanger les composants de ces éditions à votre gré pour créer une solution unique pour votre application dédiée.
| purpose | select the names of all the TiddlyWiki editions |
|---|---|
| input | ignored |
| parameter | none |
| output | the name of each TiddlyWiki edition, in alphabetical order |
- Note
- This operator is not available when TiddlyWiki is running in a web browser.
Liste les noms et descriptions des éditions disponibles. La commande --init permet de créer un nouveau wiki à partir d'une édition particulière.
--editionsHow it Works
The editor toolbar is a toolbar that helps you format text easily. It appears above the text input field in a tiddler when in edit mode. It has a similar appearance to desktop text editors like Microsoft Word or Libre Office Write.
What the Editor toolbar does
When you press the button for a function, it will insert the WikiText in the text field. As an example, if you press the bold button it will insert '' ''.
If you highlight a piece of text the markup code will automatically go around the highlighted text.
If you are in another mode, like MarkDown, the toolbar will change to that syntax and insert appropriate code. However It will not change previously typed text or markup.
Besides the standard WikiText formatting, the Editor toolbar has the following buttons:
Introduction
The edit text widget provides a user interface in the browser for editing text tiddler fields. The editing element is dynamically bound to the underlying tiddler value: changes to the tiddler are instantly reflected, and any edits are instantly propogated.
By default, the edit text widget generates a <textarea> as the HTML editing element when the text field is edited, and a <input type="text"> element otherwise. This behaviour can be overridden with the tag and type attributes.
Content and Attributes
The content of the <$edit-text> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | The tiddler to edit (defaults to the CurrentTiddler) |
| field | The field to edit (defaults to text). Takes precedence over the index attribute |
| index | The index to edit |
| default | The default text to be provided when the target tiddler doesn't exist |
| class | A CSS class to be assigned to the generated HTML editing element |
| placeholder | Placeholder text to be displayed when the edit field is empty |
| focusPopup | Title of a state tiddler for a popup that is displayed when the editing element has focus |
| tag | Overrides the generated HTML editing element tag. Use textarea for a multi-line editor |
| type | Overrides the generated HTML editing element type attribute |
| size | The size of the input field (in characters) |
| autoHeight | Either "yes" or "no" to specify whether to automatically resize textarea editors to fit their content (defaults to "yes") |
| minHeight | Minimum height for automatically resized textarea editors, specified in CSS length units such as "px", "em" or "%" |
Notes
One trap to be aware of is that the edit text widget cannot be used to edit a field of the tiddler that contains it. Each keypress results in the tiddler being re-rendered, which loses the cursor position within the text field.
Instead, place the edit text widget in a template that references the tiddler you want to modify.
For example, if you wanted to edit the value of the "myconfig" field of the tiddler "AppSettings", you might do so by creating a separate tiddler "ChangeAppSettings" that contains the following:
<$edit-text tiddler="AppSettings" field="myconfig"/>Introduction
The edit widget provides a general purpose interface for editing a tiddler. It dynamically chooses the appropriate widget depending on the type of the tiddler (currently either the EditTextWidget or the EditBitmapWidget).
Content and Attributes
The content of the <$edit> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | The tiddler to edit (defaults to the current tiddler) |
| field | The field to edit (defaults to text). Takes precedence over the index attribute |
| index | The index to edit |
| class | A CSS class to be added the generated editing widget |
This method is useful if, for any reason, you should find your current TiddlyWiki instance is not saving (e.g. a plugin or a server has stopped working). It should work on just about any platform.
- Go to advanced search
- Goto the filter tab
- Enter the following filter text:
[!is[system]!sort[modified]limit[25]]- Check the list of tiddlers.
- Adjust the number "25" in the filter to make sure you found all your recently modified tiddlers
- Press the bucket with the up arrow [] which appears on the right
- A dialogue window will ask for a location to download a file called tiddler.json on your local drive, or depending on browser configuration, just alert you that such a file will be downloaded. Press save.
- The
tiddlers.jsonfile can be imported (tools in sidebar) or drag and drop the file on the top line of the story river of another TW .- You can (de)select specific tiddlers.
- Finally, press
import.
L'édition « basique » de TiddlyWiki est une distribution minimale, sans plugin additionnel ni configuration au-delà du code principal.
L'édition basique peut être récupérée à l'adresse :
Si le bouton ne fonctionne pas, enregistrez ce lien : https://tiddlywiki.com/languages/fr-FR/empty.html
Votre navigateur vous demandera peut-être d'accepter explicitement l'enregistrement avant qu'il démarre
| purpose | apply HTML encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with HTML encoding applied |
"HTML encoding" means replacing special HTML characters with the corresponding HTML entity:
&replaced with&<replaced with<>replaced with>"replaced with"
[[Title with <angle brackets>]] +[encodehtml[]]
[[Title with an & ampersand]] +[encodehtml[]]
| purpose | apply URI encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with URI encoding applied |
[[Title with Space]] +[encodeuri[]]
[[Title with Space]] [[Another title with Space]] +[encodeuri[]]
| purpose | apply URI component encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with URI component encoding applied |
See Mozilla Developer Network for details of the encodeURIComponent operation.
[[Title with Space]] +[encodeuricomponent[]]
[[Title with Space]] [[Another title with Space]] +[encodeuricomponent[]]
Lorsqu'il est utilisé comme un fichier HTML unique, TiddlyWiki5 permet de crypter le contenu à l'aide de la Stanford JavaScript Crypto Library.
- Allez à l'onglet Outils sur la barre latérale, et cherchez le bouton avec une icône de cadenas
- Si le bouton a pour intitulé « affecter un mot de passe », c'est que le wiki en cours n'est pas crypté. Cliquer sur le bouton vous demandera un mot de passe qui sera utilisé pour les prochains enregistrements
- Si le bouton est intitulé « résilier le mot de passe », cela signifie que le wiki en cours est déjà crypté. Cliquer sur le bouton supprimera le mot de passe de sorte que les enregistrements suivants ne seront pas cryptés
- Si vous voulez vérifier que vos données sont bien cryptées, vous pouvez ouvrir le fichier enregistré dans un éditeur de texte (faites attention de ne pas le modifier !)
- Ouvrez le fichier dans votre navigateur. Avant d'afficher le contenu, un mot de passe vous sera demandé.
Introduction
The encrypt widget renders a filtered list of tiddlers to an encrypted block with the password currently held in the PasswordVault. The encrypted block can subsequently be decrypted by the TiddlyWiki5 BootMechanism. See the EncryptionMechanism for more details.
Content and Attributes
The content of the <$encrypt> widget is ignored.
| Attribute | Description |
|---|---|
| filter | Filter defining the tiddlers to be included in the encrypted block. If not specified then all non-system tiddlers are used |
| purpose | select titles from the operand interpreted as a title list |
|---|---|
| input | ignored |
! input | a selection of titles |
| parameter | L = a title list |
| output | the titles stored as a title list at L |
! output | those input titles that are not listed in L |
<$set name="myList" value="first [[second with a space]] third">
<$list filter="[enlist<myList>]">
...Introduction
The entity widget displays a specified HTML character entity.
Content and Attributes
The content of the <$entity> widget is not used.
| Attribute | Description |
|---|---|
| entity | The entity to display (eg, ×) |
TiddlyWiki pour Node.js reconnaît les variables d'environnement système ci-dessous pour spécifier une liste de chemins (séparés par des deux-points), où chercher les différents plugins et « éditions » :
TIDDLYWIKI_PLUGIN_PATH— Chemin de recherche pour les plugins ordinairesTIDDLYWIKI_THEME_PATH— Chemin de recherche pour les thèmesTIDDLYWIKI_LANGUAGE_PATH— Chemin de recherche pour les languesTIDDLYWIKI_EDITION_PATH— Chemin de recherche pour les éditions (utilisé par la commande Init).
Ces chemins supplémentaires doivent tous pointer vers des dossiers structurés comme leurs répertoires équivalents de l'arborescence TiddlyWiki5 sous GitHub : les répertoires de plugins, thèmes et langues contiennent publisher/nomduplugin/<fichiers> tandis que les répertoires des
« éditions » contiennent nomedition/<fichiers>
Exemple :
TIDDLYWIKI_PLUGIN_PATH=~/MonMagasinDePlugins
tiddlywiki monwiki --build index| purpose | escape special characters used in regular expressions |
|---|---|
| input | a selection of titles |
| output | the input with escaping applied to special regular expression characters |
See Mozilla Developer Network for details of the regular expression syntax.
I collect my tw5 creations on-line as http://eucaly-tw5.tiddlyspot.com/
Available Plugins :
- TitleMe - Return in-place tiddler title, to link / show / edit the source tiddler
- QuickJump - Quick jump to tiddlers in story list
- FlexWidth - Flexibly tweak sidebar width for TiddlyWiki 5 (Inspired by TW5 tristate Sidebar)
- MatchFilter - returns matching text instead of a list of the tiddlers from FieldFilter
- PopupTagger - TagBar / TagTable with popup list of tags (Inspired by MonkeyTaggerMacro for TiddlyWiki classic)
{
"name": "MyStuff",
"description": "A description of this wiki",
"dependencies": {
"sax": "1.2.4",
"tiddlywiki": "*"
}
}<div class="tc-table-of-contents">
<<toc-selective-expandable "Contents">>
</div><div class="tc-table-of-contents">
<<toc-expandable "Contents" "sort[title]">>
</div>
Select a topic in the table of contents. Click the arrow to expand a topic.
<$macrocall
$name="toc-tabbed-external-nav"
tag="TableOfContents"
selectedTiddler="$:/temp/toc/selectedTiddler"
unselectedText="<p>Select a topic in the table of contents. Click the arrow to expand a topic.</p>"
missingText="<p>Missing tiddler.</p>"
/>
Choisir un article dans la table des matières. Cliquer sur la flêche pour le développer.
<$macrocall
$name="toc-tabbed-internal-nav"
tag="TableOfContents"
selectedTiddler="$:/temp/toc/selectedTiddler"
unselectedText="<p>Choisir un article dans la table des matières. Click the arrow to expand a topic.</p>"
missingText="<p>Tiddler manquant.</p>"
/>{
"description": "My wiki",
"plugins": [
"tiddlywiki/tiddlyweb",
"tiddlywiki/filesystem"
],
"themes": [
"tiddlywiki/vanilla",
"tiddlywiki/snowwhite"
]
}
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
<system.webServer>
<handlers>
<add
name="httpplatformhandler"
path="*"
verb="*"
modules="httpPlatformHandler"
resourceType="Unspecified"
requireAccess="Script" />
</handlers>
<httpPlatform
stdoutLogEnabled="true"
stdoutLogFile=".\node.log"
startupTimeLimit="20"
processPath="C:\Program Files\nodejs\node.exe"
arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki --listen port=PORT path-prefix=/MyApp">
<environmentVariables>
<environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%" />
<environmentVariable name="NODE_ENV" value="Production" />
</environmentVariables>
</httpPlatform>
</system.webServer>
</configuration>
Cette compilation montre des exemples intéressants et inspirants d'utilisation de TiddlyWiki qu'on peut trouver dans la nature. Proposez de nouvelles entrées pour cette collection via GitHub, Twitter ou en postant sur les groupes de discussion TiddlyWiki.
TriTarget.org by Devin Weaver
https://tritarget.org
Posted il y a 2 ans
A personal website built with TiddlyWiki.
TriTarget.org is a name I came up with in high school. I was big into computer programming and wanted a company name that was kinda catchy. When I made a few programs in BASIC I would brand them with TriTarget as a way to show off my company (Even though I didn't have one).
Interactive Git Documentation by Devin Weaver
http://sukima.github.io/GitFixUm/
Posted il y a 3 ans
A git choose-your-own-adventure!ⓡ for walking yourself though fixing a broken Git repository.
http://sukima.github.io/GitFixUm/
This document is an attempt to be a fairly comprehensive guide to recovering from what you did not mean to do when using git. It isn't that git is so complicated that you need a large document to take care or your particular problem, it is more that the set of things that you might have done is so large that different techniques are needed depending on exactly what you have done and what you want to have happen.
"PETTIL - Forth for the Commodore PET" by Charlie Hitselberger
http://chitselb.com/files/tiddlypettil.html
Posted il y a 3 ans
Un interprète Forth véloce pour le Commodore PET, écrit en langage assembleur 6502. Le TiddlyWiki contenant la documentation du programme est automatiquement engendré à partir du code source : voir https://github.com/chitselb/pettil.
Les objectifs du projet étaient, sans ordre particulier :
- faire un interpréteur Forth exécutable sur mon Commodore PET 2001
- prendre du plaisir
- développer mes compétences en "assembleur 6502"
- trouver d'autres personnes intéressées par le projet
"A Thesis Notebook" by Alberto Molina
http://tesis.tiddlyspot.com/
Posted il y a 3 ans
Un carnet de thèse, basé sur TiddlyWiki.
Voici un exemple de carnet de thèse réalisé avec TiddlyWiki 5.0.8-beta.
TiddlyWiki est un très beau logiciel de Jeremy Ruston. Il vous permet, entre autres choses, de prendre des notes, de gérer vos idées, de garder des informations, et d'afficher un tas de choses de la façon que vous choisirez. C'est un outil incroyablement malléable que vous pouvez adapter à la plupart de vos besoins.
Ce TiddlyWiki a été personnalisé pour être utilisé comme un carnet de notes sur la philosophie, récapitulant auteurs, ouvrages, articles, concepts, théories, et notes personnelles. Je l'utilise avec Zotero, un logiciel spécialisé de bibliographie. Les deux sont des projets libres et ouverts. TiddlyWiki peut-être téléchargé sur https://tiddlywiki.com.
PESpot Lesson Planner by Patrick Detzner
http://pespot.tiddlyspot.com
Posted il y a 3 ans
Un développement pour planifier les cours créés avec TiddlyWiki.
J'ai développé un logiciel pour assister dans la saisie et la mémorisation des information de planification des cours et ainsi faciliter/automatiser un ennuyeux travail lors de à la création du document actuel de planification des leçons.
Obadiah TOC
http://giffmex.org/experiments/obadiah.html
Posted il y a 3 ans
Une introduction à la bible d'Obadiah par Dave Gifford utilisant la macro sommaire et différents réglages personnalisés de TiddlyWiki : un bouton nouveau, ici, modifié ajout d'un viewtemplate personnalisé pour intégrer des notes ou des images dans tout tiddler, et un tiddler transcluant tout contenu, adapté pour faciliter l'impression (ce tiddler).
Simple Zork-like Game by Jed Carty
http://zorklike.tiddlyspot.com
Posted il y a 3 ans
Un jeu simple développé avec TiddlyWiki et présenté dans cet article (eng).
http://zorklike.tiddlyspot.com
J'ai voulu évaluer la possibilité de créer un certain type de jeu en utilisant seulement le noyau de tiddlywiki sans plugins ou code javascript. J'ai réalisé un jeu de fiction interactif de type zork réduit à l'essentiel. C'est le jeu le plus simple que je puisse faire à ce jour, mais je pourrai faire quelques ajouts à l'avenir. il utiliser la préversion 5.1.5 car le widget action-setfield épargne un gros travail d'élaboration de macros.
Le but était de n'utiliser que les fonctions du noyau de tiddlywiki, aussi il n'y a ni plugins, ni javascript.
Le mécanisme d'exportation qui a fait son apparition avec la version 5.1.5 de TiddlyWiki permet de sélectionner facilement un sous-ensemble de tiddlers afin de le sauvegarder dans un fichier.
Si par exemple vous souhaitez sauvegarder dans un fichier tous les tiddlers ayant un tag WikiText et contenant un champ fr-title, entrez le filtre [tag[WikiText]has[fr-title]] dans l'onglet Filtre de la Recherche avancée et choisissez Fichier de tiddlers au format JSON après avoir cliqué sur
Vous obtenez alors un fichier nommé tiddlers.json, qui contient tous les tiddlers sélectionnés et qui pourra être réutilisé plus tard via un simple glissé-déposé sur un TiddlyWiki ouvert.
The External Attachments Plugin provides support for importing tiddlers as external attachments. That means that instead of importing binary files as self-contained tiddlers, they are imported as "skinny" tiddlers that reference the original file via the _canonical_uri field. This reduces the size of the wiki and thus improves performance. However, it does mean that the wiki is no longer fully self-contained.
This plugin only works when using TiddlyWiki with platforms such as TiddlyDesktop that support the path attribute for imported/dragged files.
Les images externes dans TiddlyWiki sont des tiddlers qui pointent sur l'URI d'une image, plutôt que d'avoir à incorporer toutes les données de l'image. Ils fonctionnent mieux que l'affichage d'images incorporées, notamment avec les images de grande taille. Cependant, leur utilisation détourne TiddlyWiki de sa vocation de fichier unique.
Les images externes sont utilisées dans le navigateur. Elles peuvent être créées soit par la configuration Node.js lors de la production d'un TiddlyWiki, soit manuellement en éditant un TiddlyWiki dans le navigateur .
Qu'est-ce qu'une image externe
Une image externe est un tiddler image ordinaire avec un champ _canonical_uri contenant l'URI de l'image. L'URI pointe de façon absolue ou relative vers le document HTML. Si le champ _canonical_uri est renseigné, alors le champ text du tiddler est ignoré et peut être omis.
Création manuelle d'Images Externes
Pour créer manuellement une image externe, il suffit juste de créer un tiddler avec le type de contenu image approprié, puis d'ajouter un champ _canonical_uri dont l'URI pointe vers l'emplacement de stockage de l'image.
IMPORTANT : Revérifiez votre orthographe. _canonical_uri s'épelle URI, et pas URL.
Création d'images externes sous Node.js
Suivre les étapes suivantes pour créer une version HTML statique d'un fichier wiki accompagné d'un dossier images contenant les références des images externes :
- Créer des Tiddlers image dans votre TiddlyWikiFolders de façon habituelle
- Sauvegardez les images en fichiers séparées (par convention, dans le sous-répertoire nommé images)
- Externalisez les Tiddlers image en leur attribuant un champ _canonical_uri
- Sauvegardez le fichier HTML principal
Notez que les fichiers images doivent être sauvegardés avant d'être externalisés. Leur externalisation écrasera les champs text de la mémoire de votre wiki, ce qui signifie que toute tentative de sauvegarde échouera.
Pour un exemple, voir la génération de la cible externalimages dans la demo tw5.com wiki :
--savetiddlers [is[image]] images
--setfield [is[image]] _canonical_uri $:/core/templates/canonical-uri-external-image text/plain
--setfield [is[image]] text "" text/plain
--rendertiddler $:/core/save/all externalimages.html text/plainSauvegardez les images en fichiers séparées
La commande --savetiddlers suivante peut être utilisée pour sauvegarder les images d'un wiki dans un sous-répertoire images :
--savetiddlers [is[image]] imagesExternalisez les Tiddlers Image
Deux commandes --setfield sont utilisées : la première affecte au champ _canonical_uri l'URI correspondant au titre du tiddler, et la deuxième efface le champ text.
--setfield [is[image]] _canonical_uri $:/core/templates/canonical-uri-external-image text/plain
--setfield [is[image]] text "" text/plainLe tiddler gabarit $:/core/templates/canonical-uri-external-image contient :
<!-- This template is used to assign the ''_canonical_uri'' field to external images. Change the `./images/` part to a different base URI. The URI can be relative or absolute. --> ./images/<$view field="title" format="doubleurlencoded"/>
Notez que ces opérations modifient les tiddlers dans la mémoire du wiki et peuvent donc affecter le fonctionnement de commandes ultérieures.
Utilisation d'Images Externes
Vous ne pouvez pas éditer une image externe directement dans le navigateur, sauf en changeant le champ URI pour pointer vers une image différente.
Plus d'informations sur les fonctionnalités spécifiques de TiddlyWiki :
- Images externes
- Panneau d'information
- Permaliens
- MathML
- TiddlyDesktop
- Sauvegarde automatique
- Format des dates
- Drag and Drop
- Pérénité
- Importing Tiddlers
- Chargement différé (Lazy Loading)
- Modals
- Notifications
- Mode Sans Échec
- Adaptabilité
- Chercher avec TiddlyWiki
- StartupActions
- Editor toolbar
- Raccourcis clavier
- Obtenir la dernière version
- Using SVG
- AlertMechanism
- Cryptage
- WebServer
- Audio
- Importer du contenu
- SVG, son Utilisation
- Des outils d'interface utilisateur conviviaux comme , et
- Essayez le
- Explorez le plugin de visualisation D3.js
- Accédez à CodeMirror par plugin
- Notez avec Markdown par plugin
- Conservez le marquage TiddlyWiki Classic par plugin
- Enfin, mais non des moindres, TiddlyWiki est un des rares exemples d'utilisation d'une quine au quotidien.
Federatial Limited is a software consultancy founded by JeremyRuston, the creator of TiddlyWiki. Federatial helps organisations explore new user interaction concepts through rapid prototyping of sophisticated web-based tools.
See https://federatial.com/ and https://twitter.com/federatial for more information.
Federatial Limited est une entreprise de consulting fondée par JeremyRuston et spécialisée dans la compréhension des impacts du web sur le travail collaboratif.
Visitez http://federatial.com/ et http://twitter.com/federatial pour plus d'information.
Télécharge un ou plusieurs fichiers via HTTP/HTTPS, puis importe les tiddlers correspondant à un filtre, en transformant optionnellement les titres des tiddlers importés.
--fetch file <url> <filtre-import> <filtre-de-transformation>
--fetch files <filtre-urls> <filtre-import> <filtre-de-transformation>Avec la variante "file", un seul fichier est téléchargé et le premier paramètre est l'URL du fichier à lire.
Avec la variante "files", plusieurs fichiers sont téléchargés et le premier paramètre est un filtre produisant une liste d'URLs pour les fichiers à lire. Par exemple, étant donné un ensemble de tiddlers tagués "remote-server" et disposant d'un champ "url", le filtre [tag[remote-server]get[url]] permet de récupérer toutes les URLs disponibles.
Le paramètre <filtre-import> spécifie un filtre qui détermine quels tiddlers seront importés. Lorsqu'il n'est pas indiqué, il prend comme valeur par défaut [all[tiddlers]].
Le paramètre <filtre de transformation> spécifie un filtre optionnel qui transforme les titres des tiddlers importés. Par exemple, [addprefix[$:/myimports/]] permettrait d'ajouter le préfixe $:/myimports/ à chaque titre.
On obtient des informations concernant la progression de l'importation en faisant précéder la commande --fetch de la commande --verbose.
Il faut noter que TiddlyWiki ne téléchargera pas une version plus ancienne d'un plugin déjà chargé.
L'exemple ci-dessous récupère tous les tiddlers non-système de https://tiddlywiki.com et les enregistre dans un fichier JSON :
tiddlywiki --verbose --fetch file "https://tiddlywiki.com/" "[!is[system]]" "" --rendertiddler "$:/core/templates/exporters/JsonFile" output.json text/plain "" exportFilter "[!is[system]]"| purpose | filter the input by field |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a field |
| parameter | S = a possible value of field F |
| output | those input tiddlers in which field F has the value S |
! output | those input tiddlers in which field F does not have the value S |
If S is empty, field will match both of the following:
- tiddlers that don't contain field
F - tiddlers in which field
Fexists but has an empty value
The syntax of a filter step treats any unrecognised filter operator as if it was the suffix to the field operator. See the examples.
<$fieldmangler>
Add tag ''example'' to this tiddler (current)<$button message="tm-add-tag" param="example">{{$:/core/images/new-button}}</$button>
<br>
Remove tag ''example'' to this tiddler (current)<$button message="tm-remove-tag" param="example">{{$:/core/images/delete-button}}</$button>
</$fieldmangler>
Introduction
The field mangler widget manipulates the fields and tags of a tiddler. It does so in response to the following Messages:
| Message | Description |
|---|---|
| tm-remove-field | Remove the field specified in event.param |
| tm-add-field | Add the field specified in event.param |
| tm-remove-tag | Remove the tag specified in event.param |
| tm-add-tag | Add the tag specified in event.param |
Content and Attributes
The field mangler widget displays any contained content, and responds to Messages dispatched within it.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler to manipulate (defaults to the current tiddler) |
| purpose | select all field names of the input titles |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | all the field names contained in the input tiddlers |
Each input title is processed in turn. Its list of field names is retrieved (in no particular order) and then dominantly appended to the operator's output.
Introduction
The fields widget renders each field of a specified tiddler through a simple text template. A list of fields to exclude can be provided. It is used internally by TiddlyWiki5, notably by the FileSavingMechanism.
Template Handling
The provided template is rendered with the following special substitutions:
| Symbol | Substitution |
|---|---|
| $name$ | Field name |
| $value$ | Field value |
| $encoded_value$ | HTML encoded form of field value |
Content and Attributes
The content of the <$fields> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler from which the fields are to be displayed (defaults to the current tiddler) |
| template | Text of the template (see above) |
| exclude | Lists of fields to be excluded (defaults to "text") |
| stripTitlePrefix | If set to "yes" then curly bracketed prefixes are removed from titles (for example {prefix}HelloThere converts to HelloThere) |
The stripTitlePrefix attribute is used when building TiddlyWiki Classic; see editions/tw2 in the TiddlyWiki5 repo.
L'expression d'un filtre est le plus haut niveau de la syntaxe d'un filtre.Elle est composée d'une ou plusieurs séquences.
Une entrée de séquence est souvent une liste de tous les titres des tiddlers non-shadow du wiki (sans tri particulier). Mais le préfixe + peut modifier cela.
- Si une séquence ne comporte pas de préfixe
+ou-, ces titres en sortie sont ajoutés par prépondérance au résultat du filtre. - Si une séquence comporte un préfixe
-, les titres en sortie sont extraits du résultat du filtre (s'ils y étaient). - Si une séquence comporte un préfixe
+, elle compare les sorties du filtre à ses entrées. La sortie du filtre est alors entièrement remplacée par les séquences qui se recoupent. Toutes séquences de titres de tiddler suivantes sont traitées comme des entrées, à moins qu'elles n'aient aussi un préfixe+.
En termes techniques plus concis :
| Séquence | Interpretation | Output |
|---|---|---|
séquence | réunion | ... OR séquence |
+séquence | intersection | ... AND séquence |
-séquence | exclusion | ... AND NOT séquence |
Un opérateur de filtre est un motclé prédéfini attaché à une étape individuelle d'un filtre. Il définit une action particulière de cette étape.
Le tableau suivant liste tous les opérateurs du noyau. Les plus communs sont côchés. La troisième colonne indique quels opérateurs acceptent le ! préfixe pour inverser leur expression.
| Opérateur | Propose | Neg |
|---|---|---|
| all | find all titles of a fundamental category | |
| backlinks | find the titles that link to each input title | |
| contains | filter the input by searching list fields for a value | ! |
| count | count the number of entries in a list | |
| days | filter the input by date | ! |
| each | select one of each group of input titles by field | |
| eachday | select one of each group of input titles by date | |
| enlist | select titles from the operand interpreted as a title list | ! |
| field | filter the input by field | ! |
| fields | select all field names of the input titles | |
| get | select all values of a field in the input titles | |
| getindex | select all values of a data property in the input titles | |
| has | filter the input by field existence | ! |
| haschanged | filter the input by tiddler modification status | ! |
| indexes | select all data properties of the input titles | |
| is | filter the input by fundamental category | ! |
| links | find the titles linked to by each input title | |
| list | select titles via a list field | ! |
| listed | find the titles that list the input titles | |
| lookup | applies a prefix to each input title to yield the title of a tiddler from which the final value is retrieved | |
| minlength | filter items shorter than the specified minimum length | |
| range | generate a range of numbers | ! |
| regexp | filter the input by pattern-matched field | ! |
| sameday | filter the input by date | |
| search | filter the input by searching tiddler content | ! |
| subfilter | select titles from the operand interpreted as a filter expression | ! |
| title | select a single title | ! |
| Opérateurs de classement | ||
| after | find which input title follows a specified one | |
| allafter | discard all items except those after the marker | |
| allbefore | discard all items except those before the marker | |
| append | append a range of items from an array to the list | |
| before | find which input title precedes a specified one | |
| bf | same as rest |
|
| butfirst | same as rest |
|
| butlast | discard the last N input titles |
|
| first | select the first N input titles |
|
| insertbefore | insert an item T into a list immediately before an item B |
|
| last | select the last N input titles |
|
| limit | select the first or last N input titles |
! |
| move | move marker N places in the list | |
| next | find which titles in a list field follow the input ones |
|
| nsort | sort the input by number field | ! |
| nsortcs | sort the input titles by number field, treating upper and lower case as different | ! |
| nth | select the Nth input title |
|
| order | selectively reverse the input list | |
| prepend | prepend a range of items from an array to the list | |
| previous | find which titles in a list field precede the input ones |
|
| putafter | move N trailing items after the marker | |
| putbefore | move N trailing items before the marker | |
| putfirst | move N trailing items to the head of the list | |
| putlast | move N leading items to the tail of the list | |
| remove | remove a list of titles specified in the operand from the input | |
| replace | replace marker with N trailing items | |
| rest | discard the first N input titles |
|
| reverse | reverse the order of the input titles | |
| sort | sort the input by text field | ! |
| sortan | sort the input by text field considering them as alphanumerics | ! |
| sortby | sort the current list in the order of the list referenced in the operand | |
| sortcs | sort the input by text field, treating upper and lower case as different | ! |
| Opérateurs de chaine | ||
| addprefix | extend each input title with a prefix | |
| addsuffix | extend each input title with a suffix | |
| decodehtml | apply HTML decoding to a string | |
| decodeuri | apply URI decoding to a string | |
| decodeuricomponent | apply URI component decoding to a string | |
| encodehtml | apply HTML encoding to a string | |
| encodeuri | apply URI encoding to a string | |
| encodeuricomponent | apply URI component encoding to a string | |
| escaperegexp | escape special characters used in regular expressions | |
| jsonstringify | apply JSON string encoding to a string | |
| prefix | filter the input titles by how they start | ! |
| removeprefix | filter the input titles by how they start, deleting that prefix | |
| removesuffix | filter the input titles by how they end, deleting that suffix | |
| splitbefore | select a delimited prefix from each input title | |
| stringify | apply JavaScript string encoding to a string | |
| suffix | filter the input titles by how they end | ! |
| Opérateurs de tag | ||
| tag | filter the input by tag | ! |
| tagging | find the tiddlers that have the input tags | |
| tags | select all tags of the input tiddlers | |
| untagged | discard any input titles that have tags | ! |
| Opérateurs Spéciaux | ||
| commands | select the titles of all the Node.js commands | |
| editiondescription | select the descriptions of the input editions | |
| editions | select the names of all the TiddlyWiki editions | |
| modules | select the names of all modules of the input module types | |
| moduletypes | select the names of all TiddlyWiki module types | |
| plugintiddlers | select all shadow titles in the input plugins | |
| shadowsource | select the plugin titles that contain the input shadows | |
| storyviews | select the names of all the story views | |
| subtiddlerfields | select all fields present in the selected tiddlers within a plugin | |
La rédaction d'une étape typique s'écrit [opérateur[paramètre]], même si tous les opérateurs ne nécessitent pas de paramètre.
La plupart des étapes agissent sur les titres d'une sélection qu'ils ont en entrée, mais quelques uns construisent une sélection entièrement neuve à la place. Pour des règles précises, voir Syntaxe des filtres.
Le paramètre de l'opérateur de filtre peut être :
- dur
[comme ceci]- Le paramètre est le texte exact tel qu'il apparait entre les crochets.
- souple
- indirect
{comme ceci}- Le paramètre est le texte mentionné par la Référence Textuelle dont le nom apparaît entre les accolades, c'est à dire un champ d'un tiddler spécifique, ou la valeur d'une propriété d'un tiddler de données.
- variable
<comme ceci>- Le paramètre est la valeur actuelle de la variable dont le nom apparaît entre les chevrons. Les paramètres Macro ne sont pas supportés.
Une séquence se compose d'étapes. Elle génère une sélection. Un ensemble de séquences forme une vaste expression filtre.
Les étapes sont traitées de gauche à droite. Ce qui entre dans la première étape correspond à ce qui entre dans la séquence. Pour chaque étape suivante, l'entrée provient de la sortie de l'étape précédente.
Le résultat du filtre d'une étape dépend de son opérateur:
- La plupart des opérateurs forment leurs résultats à partir de leurs entrées. Par exemple, la plupart produisent un sous-ensemble de leur entrée, et se faisant, méritent vraiment leur nom de "filtres",car ils réduisent la taille du résultat généré par la séquence. Ces opérateurs sont nommés modifieurs de sélection.
- Quelques opérateurs ignorent leurs entrées et génèrent un résultat indépendant. Ils sont appelés constructeurs de sélection : Ils construisent une sélection entièrement nouvelle.
Un bon exemple de constructeur est l'opérateur title. Le résultat de [title[A]title[B]] est juste B. Mais l'ajout de l'opérateur modifieur field, [title[A]field:title[B] ne produit plus rien du tout.
Les trois options basses du diagramme correspondent aux syntaxes SalutàTous, "SalutàTous", 'SalutàTous' et "Opérateurs de Filtre". Ce sont des abrégés de [title[...]].
Les options cotées existent pour tenir compte des titres contenant des crochets, comme, "Un Tiddler [[[[Peucourant]]]]".
Une étape correspond à une opération unique au sein d'un filtre.
En termes de développement, cela s'apparente à l'appel d'une fonction où l'entrée d'une étape est passée comme un paramètre implicite. La sortie d'une étape est une sélection qui contribue à former une séquence et donc aussi à l'expression du filtre entière qui la contient.
L'opérateur d'étape est issu d'une liste de motsclés prédéfinis, et qui peut être étendue par des plugins. Tout opérateur inconnu est traité comme s'il était le suffixe de l'opérateur field. Si un opérateur d'étape est omis, sa valeur par défaut est title.
Le suffixe est un texte additionnel, souvent le nom d'un field, qui étend la signification de certains opérateurs.
Plusieurs étapes requièrent une valeur de paramètre explicite, aussi connue sous le nom d'opérande, qui définit ce que l'étape doit faire.
- Les Filtres suivent une grammaire représentée ici par des diagrammes en chemin de fer, pour ceux qui trouvent utile une description formelle de la syntaxe. Cependant, vous pouvez apprendre à écrire des filtres sans avoir besoin de comprendre ces tiddlers modèle de description.
Un filtre est un tube qui transforme une entrée en sortie. Les entrées et les sorties sont des ensembles ordonnés de titres de tiddlers ou de champs.
Les Filtres sont des expressions construites à partir de plus petits blocs, appelés séquences ou étapes, chacun d'entre eux transformant une entrée en sortie.
Un filtre débute avec un sortie vide. Il s'exécute de gauche à droite, puis progressivement modifie et compose la sortie finale.
Ci-dessous, les détails des différents blocs de construction impliqués :
L'opérateur de filtre fields est un sélecteur qui renvoie les noms de tous les champs utilisés dans les tiddlers sélectionnés.
| Chaîne de filtre | Description |
|---|---|
[[HelloThere]fields[]] | Renvoie les champs présents dans le tiddler HelloThere |
[tag[monTag]fields[]] | Renvoie l'ensemble de tous les champs présents dans les tiddlers ayant pour tag monTag |
Un opérateur de filtre est un motclé prédéfini attaché à une étape individuelle d'un filtre. Il définit une action particulière de cette étape.
Le tableau suivant liste tous les opérateurs du noyau. Les plus communs sont côchés. La troisième colonne indique quels opérateurs acceptent le ! préfixe pour inverser leur expression.
| Opérateur | Propose | Neg |
|---|---|---|
| all | find all titles of a fundamental category | |
| backlinks | find the titles that link to each input title | |
| contains | filter the input by searching list fields for a value | ! |
| count | count the number of entries in a list | |
| days | filter the input by date | ! |
| each | select one of each group of input titles by field | |
| eachday | select one of each group of input titles by date | |
| enlist | select titles from the operand interpreted as a title list | ! |
| field | filter the input by field | ! |
| fields | select all field names of the input titles | |
| get | select all values of a field in the input titles | |
| getindex | select all values of a data property in the input titles | |
| has | filter the input by field existence | ! |
| haschanged | filter the input by tiddler modification status | ! |
| indexes | select all data properties of the input titles | |
| is | filter the input by fundamental category | ! |
| links | find the titles linked to by each input title | |
| list | select titles via a list field | ! |
| listed | find the titles that list the input titles | |
| lookup | applies a prefix to each input title to yield the title of a tiddler from which the final value is retrieved | |
| minlength | filter items shorter than the specified minimum length | |
| range | generate a range of numbers | ! |
| regexp | filter the input by pattern-matched field | ! |
| sameday | filter the input by date | |
| search | filter the input by searching tiddler content | ! |
| subfilter | select titles from the operand interpreted as a filter expression | ! |
| title | select a single title | ! |
| Opérateurs de classement | ||
| after | find which input title follows a specified one | |
| allafter | discard all items except those after the marker | |
| allbefore | discard all items except those before the marker | |
| append | append a range of items from an array to the list | |
| before | find which input title precedes a specified one | |
| bf | same as rest |
|
| butfirst | same as rest |
|
| butlast | discard the last N input titles |
|
| first | select the first N input titles |
|
| insertbefore | insert an item T into a list immediately before an item B |
|
| last | select the last N input titles |
|
| limit | select the first or last N input titles |
! |
| move | move marker N places in the list | |
| next | find which titles in a list field follow the input ones |
|
| nsort | sort the input by number field | ! |
| nsortcs | sort the input titles by number field, treating upper and lower case as different | ! |
| nth | select the Nth input title |
|
| order | selectively reverse the input list | |
| prepend | prepend a range of items from an array to the list | |
| previous | find which titles in a list field precede the input ones |
|
| putafter | move N trailing items after the marker | |
| putbefore | move N trailing items before the marker | |
| putfirst | move N trailing items to the head of the list | |
| putlast | move N leading items to the tail of the list | |
| remove | remove a list of titles specified in the operand from the input | |
| replace | replace marker with N trailing items | |
| rest | discard the first N input titles |
|
| reverse | reverse the order of the input titles | |
| sort | sort the input by text field | ! |
| sortan | sort the input by text field considering them as alphanumerics | ! |
| sortby | sort the current list in the order of the list referenced in the operand | |
| sortcs | sort the input by text field, treating upper and lower case as different | ! |
| Opérateurs de chaine | ||
| addprefix | extend each input title with a prefix | |
| addsuffix | extend each input title with a suffix | |
| decodehtml | apply HTML decoding to a string | |
| decodeuri | apply URI decoding to a string | |
| decodeuricomponent | apply URI component decoding to a string | |
| encodehtml | apply HTML encoding to a string | |
| encodeuri | apply URI encoding to a string | |
| encodeuricomponent | apply URI component encoding to a string | |
| escaperegexp | escape special characters used in regular expressions | |
| jsonstringify | apply JSON string encoding to a string | |
| prefix | filter the input titles by how they start | ! |
| removeprefix | filter the input titles by how they start, deleting that prefix | |
| removesuffix | filter the input titles by how they end, deleting that suffix | |
| splitbefore | select a delimited prefix from each input title | |
| stringify | apply JavaScript string encoding to a string | |
| suffix | filter the input titles by how they end | ! |
| Opérateurs de tag | ||
| tag | filter the input by tag | ! |
| tagging | find the tiddlers that have the input tags | |
| tags | select all tags of the input tiddlers | |
| untagged | discard any input titles that have tags | ! |
| Opérateurs Spéciaux | ||
| commands | select the titles of all the Node.js commands | |
| editiondescription | select the descriptions of the input editions | |
| editions | select the names of all the TiddlyWiki editions | |
| modules | select the names of all modules of the input module types | |
| moduletypes | select the names of all TiddlyWiki module types | |
| plugintiddlers | select all shadow titles in the input plugins | |
| shadowsource | select the plugin titles that contain the input shadows | |
| storyviews | select the names of all the story views | |
| subtiddlerfields | select all fields present in the selected tiddlers within a plugin | |
La rédaction d'une étape typique s'écrit [opérateur[paramètre]], même si tous les opérateurs ne nécessitent pas de paramètre.
La plupart des étapes agissent sur les titres d'une sélection qu'ils ont en entrée, mais quelques uns construisent une sélection entièrement neuve à la place. Pour des règles précises, voir Syntaxe des filtres.
Vous pouvez vous représenter TiddlyWiki comme une base de données où tous les enregistrements sont des tiddlers. Une base de données propose typiquement un moyen de découvrir quels enregistrements satisfont à des critères donnés, avec TiddlyWiki c'est effectué par les filtres.
Un filtre est une notation notation concise pour sélectionner un ensemble de tiddlers particuliers, envoyé dans une output. Quand TiddlyWiki rencontre un filtre, il calcule l'output (la sortie). D'autres tâches peuvent être réalisées avec ces tiddlers, comme le dénombrement ou leur listage.
L'exemple qui suit envoie la sortie d'un filtre à la macro list-links pour afficher la liste des tiddlers qui commencent par la lettre H :
<<list-links "[prefix[H]]">>
La sortie d'un filtre peut changer selon que des tiddlers sont ajoutés ou supprimés du wiki. TiddlyWiki recalcule à la volée, actualisant automatiquement aussi bien les dénombrements basés sur des filtres que les listages.
La Recherche Avancée a un onglet Filtrer qui facilite l'expérimentation et l'apprentissage des filtres.
- En savoir plus :
- Introduction à la rédaction d'un filtre – un didacticiel pas à pas
- Syntaxe des Filtres – les règles techniques détaillées
- Opérateurs des Filtres – les méthodes de filtrages disponibles
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
| purpose | select the first N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | the first N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]first[]]
[list[Days of the Week]first[5]]
[tag[Filter Operators]!sort[title]first[]]
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Voici les formatages de texte disponibles en WikiTexte :
| Format | Résultat |
''gras'' | texte en gras |
//italique// | texte en italique |
__souligné__ | texte souligné |
~~barré~~ | texte |
`code```code contenant du `code` `` | codecode contenant du `code` |
^^exposant^^ | texte en exposant |
,,indice,, | texte en indice |
Voir aussi : WikiTexte : blocs de code
- Remarque
- Si le code inclus est à la fin du code contenant, l'espace entre le
`et les``est nécessaire.
Sometimes you want the results of a <$list> widget to be formatted in the form of multiple columns instead of just one straight listing. The following method creates an actual table structure and uses the nth operator to provide break points for the rows. It is not responsive, that is, it doesn't re-position to display fewer columns if the window is too small.
In the first, outer list structure you must provide a count to indicate at item number rows should occur. So, in the following example, each row breaks after 4 items, so the sequence is 1,5,9, etc. Note that this requires you to know in advance the maximum number of items there will be. There is also an internal limit that is set to n-1 items, where n is the number of columns you want.
Note also that you need to repeat the driving filter operator inside of the internal <$list> widget. Obviously this technique lends itself to a macro implementation.
For other table-making techniques see also:
- Formatting List Results as Tables with CSS - Variable Column Method
- Formatting List Results as Tables with CSS - Specified Columns Methods
Example code for a four-column table with fewer than 70 items
<table>
<$list filter="1 5 9 13 17 21 25 29 33 37 41 45 49 53 57 61 65" variable ="rows">
<$list filter="[tag[Filter Operators]limit[50]] +[nth<rows>]" variable="cell">
<tr>
<td> <<cell>> </td>
<$list filter="[tag[Filter Operators]limit[50]] +[allafter<cell>limit[3]]" variable="this">
<td> <<this>> </td>
</$list>
</tr>
</$list>
</$list>
</table>Result
| addprefix Operator | addsuffix Operator | after Operator | all Operator |
| allafter Operator | allbefore Operator | append Operator | backlinks Operator |
| before Operator | bf Operator | butfirst Operator | butlast Operator |
| commands Operator | contains Operator | count Operator | days Operator |
| decodehtml Operator | decodeuri Operator | decodeuricomponent Operator | each Operator |
| eachday Operator | editiondescription Operator | editions Operator | encodehtml Operator |
| encodeuri Operator | encodeuricomponent Operator | enlist Operator | escaperegexp Operator |
| field Operator | fields Operator | first Operator | get Operator |
| getindex Operator | has Operator | haschanged Operator | indexes Operator |
| insertbefore Operator | is Operator | jsonstringify Operator | last Operator |
| limit Operator | links Operator | list Operator | listed Operator |
| lookup Operator | minlength Operator | modules Operator | moduletypes Operator |
| move Operator | next Operator |
Sometimes you want the results of a <$list> widget to be formatted in the form of multiple columns, instead of just one straight listing. This method uses ~CSS to set up listing as columns and assumes that you know how many columns you want. The method here is to create a style that reflects the number of columns you want your table to be in, and then apply that style to the resulting list output.
For other table-making techniques see also:
- Formatting List Results as Tables with CSS - Variable Column Method
- Formatting List Results as Tables (no CSS)
1) Create a tiddler for the columns tagged with $:/tags/Stylesheet, containing:
/* FOUR COLUMN MODE */
.fourcolumns {
display:block;
-moz-column-count:4;
-moz-column-gap:1em;
-webkit-column-count: 4;
-webkit-column-gap:1em;
}Note the various places you need to indicate the number of columns
2) Then format your output like this:
@@.fourcolumns
<$list filter="[tag[Filter Operators]]" variable="foo"><br>
<<foo>>
</$list>
@@Example showing partial list of filter operators
addprefix Operator
addsuffix Operator
after Operator
all Operator
allafter Operator
allbefore Operator
append Operator
backlinks Operator
before Operator
bf Operator
butfirst Operator
butlast Operator
commands Operator
contains Operator
count Operator
days Operator
decodehtml Operator
decodeuri Operator
decodeuricomponent Operator
each Operator
eachday Operator
editiondescription Operator
editions Operator
encodehtml Operator
Sometimes you want the results of a <$list> widget to be formatted in the form of multiple columns, instead of just one straight listing. This method uses CSS to set up listing as columns. It is responsive, that is, re-positioning to display fewer columns if the window is too small.
You don't directly specify a fixed number of columns but instead specify the max-width for the list (which could be a transclusion of the tiddler width) and the width for each item. It lists from left to right, then wraps to a new row.
For other table-making techniques see also:
- Formatting List Results as Tables with CSS - Specified Columns Methods
- Formatting List Results as Tables (no CSS)
Example listing using 50 existing TiddlyWiki tags
<div class="dynamic-table">
<$list filter="[has[tags]tags[]sort[title]first[50]]">
<span class="item">
<$transclude tiddler="$:/core/ui/TagTemplate"/>
</span>
</$list>
</div>Example stylesheet to use with listing
<style>
.dynamic-table {
max-width:700px; /* could transclude tiddler width instead */
-ms-box-orient: vertical; /* might be unnecessary */
display: -webkit-box;
display: -moz-box;
display: -ms-flexbox;
display: -moz-flex;
display: -webkit-flex;
display: inline-flex;
-webkit-flex-wrap: wrap;
flex-wrap: wrap;
flex-direction: row;
}
.item {
max-width:160px; min-width:160px;
flex: 0 0 2em; /* -grow, -shrink, -basis */
}
</style>Results
Au sein d'un tiddler, vous pouvez utiliser un formatage spécifique appelé WikiText, afin de contrôler la manière dont le texte sera affiché.
Formatage simple
Dans sa plus simple expression, WikiText vous permet d'appliquer des fonctions de traitement de texte familières comme le gras, l'italique, les listes et les tableaux. Par exemple :
Portez ce //vieux// whisky au ''juge'' ~~brun~~ blond qui `fume`S'affiche ainsi :
Portez ce vieux whisky au juge brun blond qui fume
Travailler avec les tiddlers
WikiText vous permet de pointer vers d'autres tiddlers à l'aide des doubles crochets droits, ou grâce aux liens automatiques engendrés par les mots en CamelCase :
Voici un lien vers HelloThere, et un autre vers l'[[histoire de TiddlyWiki|History of TiddlyWiki]]S'affiche comme :
Voici un lien vers HelloThere, et un autre vers l'histoire de TiddlyWiki
Macros
Les macros vous permettent d'assembler des bouts de WikiText répétitifs, afin de les réutiliser facilement.
Par exemple, voici la définition d'une macro qui génère une URL vidéo YouTube à partir de son identifiant unique :
\define youtube(video)
https://www.youtube.com/watch?v=$video$
\endUne fois cette définition mise en place, <<youtube 1g66s7UbyuU>> génèrera l'URL https://www.youtube.com/watch?v=1g66s7UbyuU
WikiText avancé
Les fonctionnalités avancées de WikiText permettent de produire des listes automatisées et des fonctions interactives comme des menus déroulants. En fait, toute l'interface de TiddlyWiki est elle-même écrite en WikiText ; autrement dit, toutes les fonctionnalités que vous voyez dans TiddlyWiki peuvent être adaptées pour être utilisées dans vos propres wikis.
Certaines fonctionnalités avancées nécessitent un codage complexe. TiddlyWiki inclut plusieurs macros prédéfinies, qui simplifient les fonctions usuelles d'interface utilisateur, comme les onglets, les tables des matières, et les listes de tiddlers.
En savoir plus
Voir WikiText pour une introduction détaillée à l'écriture de WikiText.
Utilisateurs
Les groupes de discussion TiddlyWiki sont des listes de publipostage pour discuter de TiddlyWiki : demandes d'aide, annonces de nouvelles version et plugins, échanges sur les nouvelles fonctionnalités, ou simples partages d'expériences. Vous pouvez participer via le site web associé, ou souscrire par email.
- Le groupe principal de TiddlyWiki : http://groups.google.com/group/TiddlyWiki
Notez qu'il n'est nul besoin d'avoir un compte Google pour vous joindre aux groupes de discussion. Souscrire par l'envoi d'un email à mailto:tiddlywiki+subscribe@googlegroups.com ou mailto:tiddlywikidev+subscribe@googlegroups.com.
- Visualiser les enregistrements de nos réguliers TiddlyWiki Hangouts
- Suivre @TiddlyWiki sur Twitter pour les dernières nouvelles.
Développeurs
- Le groupe TiddlyWikiDev pour les dévelopeurs : http://groups.google.com/group/TiddlyWikiDev
Notez qu'il n'est nul besoin d'avoir un compte Google pour vous joindre aux groupes de discussion. Souscrire par l'envoi d'un email à mailto:tiddlywiki+subscribe@googlegroups.com ou mailto:tiddlywikidev+subscribe@googlegroups.com.
- Suivre @TiddlyWiki sur Twitter pour les dernières nouvelles.
- Impliquez-vous dans le développement sur GitHub
Les nouvelles versions de TiddlyWiki, TiddlyDesktop et TiddlyFox sont annoncés par les groupes de discussion et Twitter (vous pouvez aussi souscrire au flux Atom/RSS des versions de TiddlyWiki sur GitHub)
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
L'édition « complète » de TiddlyWiki intègre toutes les langues, thèmes et plugins disponible de la distribution officielle de TiddlyWiki. Elle est destinée aux tests de TiddlyWiki — et notamment, pour basculer entre tous les plugins linguistiques disponibles.
L'édition complète peut être téléchargée via :
A plugin to integrate the popular lunr.js search engine, giving TiddlyWiki much more sophisticated search capabilities:
https://hoelz.ro/files/fts.html
Provides an alternative search result list that orders results by search relevance and ignores differences in word forms (ex. tag vs tags).
On my personal wiki, I have the problem that there are terms I use across a lot of tiddlers, and sometimes I'll use different forms (such as the aforementioned tag vs tags). I wanted a plugin to allow me to find the tiddler I'm looking for quickly and didn't require me to worry about how I declined a noun or inflected a verb - so I wrote this plugin, which provides an alternative search list powered by lunr.js.
À présent que TiddlyWiki5 a enfin quitté son statut de « beta », j'ai bon espoir qu'il vivra longtemps. Comme il n'utilise que des fonctionnalités standard de HTML5 et Node.js, il n'y a aucune raison pour qu'il ne reste pas entièrement opérationnel dans les années qui viennent. Mon but est qu'il survive au moins 25 ans.
TiddlyWiki a été conçu avec le besoin à long terme des utilisateurs à l'esprit. Comme il est OpenSource et ne nécessite pas d'infrastructure, nous pouvons être sûrs que tout ce dont nous aurons besoin pour accéder à un fichier TiddlyWiki même dans un futur éloigné est un simple navigateur HTML. Si vous commencez à utiliser TiddlyWiki au début de votre carrière, vous pouvez être certain qu'il vous accompagnera jusqu'à la retraite.
TiddlyWiki5 can be used to generate static HTML representations of a TiddlyWiki that doesn't need JavaScript.
There is much flexibility in how the static HTML is generated. The following scenarios are all illustrated on https://tiddlywiki.com.
Wiki Snapshots and Tiddler Snapshots
You can explore a static representation of this TiddlyWiki at static.html. That file is a static snapshot of the current DefaultTiddlers. Any tiddlers that it links to are referred to via URLs of the form /static/HelloThere.html that point to static snapshots of individual tiddlers. The tiddler HTML files reference a static.css stylesheet file.
The following commands are used to generate the sample static version of the TiddlyWiki5 site:
--rendertiddlers [!is[system]] $:/core/templates/static.tiddler.html static text/plain
--rendertiddler $:/core/templates/static.template.html static.html text/plain
--rendertiddler $:/core/templates/static.template.css static/static.css text/plainThe first RenderTiddlersCommand generates the HTML representations of individual tiddlers, the second RenderTiddlerCommand saves the static version of the DefaultTiddlers, and the final RenderTiddlerCommand saves the stylesheet. (All the files are placed in the output folder of the wiki folder).
Wiki Snapshot with Internal Links
It is also possible to produce a single HTML file that contains static representations of tiddlers, and uses standard HTML anchor links to jump between them.
For example: alltiddlers.html
The example is built by the following commands:
--rendertiddler $:/core/templates/alltiddlers.template.html alltiddlers.html text/plain| purpose | select all values of a field in the input titles |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field |
| output | the values of field F in each of the input titles |
Each input title is processed in turn. If the corresponding tiddler contains field F, and the value of this field is not empty, then its value is appended to the output.
Unlike most other Filter Operators, the selection output by get can contain duplicates. To avoid duplicates, use each[F]get[F].
[all[current]get[draft.of]]
[get[tags]]
[each[tags]get[tags]]
| purpose | select all values of a data property in the input titles |
|---|
Each input title is processed in turn, and is ignored if it does not denote a data tiddler. If the tiddler contains property P, the value of that property is dominantly appended to the output.
[[$:/palettes/Vanilla]getindex[background]]
[all[shadows+tiddlers]tag[$:/tags/Palette]getindex[background]]
Ce rapide tutoriel vous explique brièvement comment enregistrer vos modifications avec un fichier TiddlyWiki autonome.
Notez que cette vidéo est un peu ancienne, et qu'elle sera mise à jour bientôt !
Instructions pour bien commencer avec TiddlyWiki, selon les différentes plates-formes et configurations supportées.
Autres informations :
- Cryptage explique comment utiliser le système de cryptage intégré à TiddlyWiki pour protéger votre contenu avec un mot de passe ;
- Enregistrer avec Tiddlyspot, un service gratuit qui vous permet d'utiliser TiddlyWiki en ligne ;
- Sauvegarde avec TiddlyDesktop, une application de bureautique dédiée au travail avec TiddlyWiki ;
- Vous pouvez aussi télécharger ce TiddlyWiki complet, avec toute sa documentation :
Si le bouton ne fonctionne pas, sauvegardez ce lien :
https://tiddlywiki.com/languages/fr-FR/index.html
Votre navigateur vous demandera sans doute confirmation avant de démarrer le téléchargement.
Deux options s'offrent à vous pour utiliser TiddlyWiki sur Android :
Firefox et TiddlyFox
(Vous pouvez aussi regarder le tutoriel vidéo).
- Assurez-vous d'avoir installé la dernière version de Firefox pour Android
- Installez la dernière version de l'extension TiddlyFox depuis :
- Installez aussi cette extension qui vous permettra de sauvegarder le fichier TiddlyWiki localement :
- Téléchargez un fichier TiddlyWiki vide en enregistrant ce lien :
(pour enregistrer le lien, assurez-vous d'avoir installé l'extension "save-link-menus", appuyez quelques secondes sur le lien, puis choisissez "Save link")
- Une fois le fichier téléchargé, cliquez dessus depuis la zone de notification ou l'application de gestion des téléchargements
- Choisissez d'ouvrir le fichier avec Firefox (et non l'application par défaut proposée par Android)
- Cliquez OK en réponse à la demande de TiddlyFox qui vous demande s'il faut activer l'enregistrement pour ce fichier
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Entrez du contenu dans le tiddler, puis cliquez sur le bouton terminé
- Sauvegardez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Attendez l'indication jaune Wiki enregistré en haut à droite de la fenêtre
- Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement enregistrées
L'application AndTidWiki
L'application AndTidWiki pour les appareils Android permet d'éditer des wikis TiddlyWiki5 et d'enregistrer les modifications, même si vous travaillez sans connexion au réseau. Vous pouvez la télécharger ici.
Notez que AndTidWiki est publiée indépendamment de TiddlyWiki
Sous Google Chrome, TiddlyWiki ne parvient à sauvegarder les modifications qu'à l'aide de la solution de repli standard : le module de sauvegarde compatible HTML5.
Cette manière d'enregistrer les modifications est assez pénible, car elle requiert une intervention manuelle à chaque enregistrement. Elle a l'avantage de fonctionner avec pratiquement tous les navigateurs tournant sur les ordinateurs de bureaux, et de nombreux navigateurs tournant sur appareils mobiles.
- Téléchargez un TiddlyWiki en cliquant sur ce bouton :
Si le bouton ne fonctionne pas, enregistrez ce lien : https://tiddlywiki.com/languages/fr-FR/empty.html
Votre navigateur vous demandera peut-être d'accepter explicitement l'enregistrement avant qu'il démarre
- Localisez le fichier que vous venez de télécharger
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
.htmlou.htm
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
- Ouvrez le fichier dans votre navigateur
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Votre navigateur téléchargera alors un nouvel exemplaire du wiki, avec vos modifications à l'intérieur
- Localisez ce nouveau fichier et ouvrez-le dans votre navigateur
- Vérifiez que vos modifications ont correctement été enregistrées
Truc: la plupart des navigateurs peuvent être configurés pour proposer un chemin d'enregistrement à chaque téléchargement. Cela vous permet de sélectionner la version précédente du fichier et ainsi de la remplacer.
C'est Firefox qui fournit la meilleure expérience d'utilisation de TiddlyWiki, grâce à l'extension TiddlyFox.
Si vous utilisez Firefox pour Android, reportez-vous aux instructions pour enregistrer avec TiddlyFox sur Android.
- Assurez-vous d'avoir la dernière version de Firefox
- Installez la dernière version de l'extension TiddlyFox à partir de :
- Redémarrez Firefox
- Téléchargez un TiddlyWiki vide en cliquant sur ce bouton :
- Localisez le fichier que vous venez de télécharger
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
.htmlou.htm
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
- Ouvrez le fichier dans Firefox
- Cliquez OK en réponse à la demande de TiddlyFox d'activer l'enregistrement pour ce fichier
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Attendez l'indication jaune Wiki enregistré en haut à droite de la fenêtre
- Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement enregistrées
- Installez l'extension TiddlyIE depuis :
- Redémarrez Internet Explorer. IE vous demandera si vous voulez activer l'extension TiddlyIE.
Il se peut aussi que vous ayez à activer le Microsoft Scripting Runtime
- Téléchargez un TiddlyWiki vide en enregistrant ce lien :
- Localisez le fichier que vous venez de télécharger
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
.htmlou.htm
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
- Ouvrez le fichier dans Internet Explorer
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale. Internet Explorer vous demandera votre assentiment pour enregistrer le fichier localement en vous présentant un dialogue Enregistrer en tant que.
- Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement sauvegardées.
Le hack Windows HTA décrit une autre manière d'utiliser TiddlyWiki avec Internet Explorer.
L'application TWEdit pour iPad/iPhone permet d'éditer et de sauvegarder des modifications de wikis TiddlyWiki5, même si vous travaillez hors ligne sans connexion réseau. Vous pouvez la télécharger ici.
Instructions d'utilisation :
- Ouvrez TWEdit
- Tapez sur le titre au centre de la barre d'outils
- Une boîte texte doit apparaître dans laquelle vous pouvez saisir une URL
- Entrez l'URL
https://tiddlywiki.com/languages/fr-FR/empty.html - Une fois le TiddlyWiki5 vide chargé, tapez sur l'icône save (il s'agit de la deuxième icône en partant de la droite sur la barre d'outils supérieure)
- Une boîte d'alerte devrait apparaître pour vous permettre d'entrer un nom de fichier local
- Entrez le nom de fichier que vous souhaitez utiliser pour le document (en le suffixant par
.html) - Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Un message de confirmation doit apparaître en haut à droite de la fenêtre
Notez que TWEdit est publié indépendamment de TiddlyWiki
- Installez Node.js depuis http://nodejs.org
- Ouvrez un terminal en ligne de commande et tapez :
npm install -g tiddlywikiSi cela échoue avec un message d'erreur, il se peut que vous ayez besoin de retaper la commande en tant qu'administrateur :
npm install -g tiddlywiki(Windows)sudo npm install -g tiddlywiki(Mac/Linux) - Vérifiez que TiddlyWiki est bien installé en tapant :
tiddlywiki --version - En réponse, vous devriez voir TiddlyWiki renvoyer la version en cours (par exemple
5.1.2; d'autres informations de débogage peuvent aussi apparaître). - Faites l'essai :
tiddlywiki monnouveauwiki --init serverpour créer un dossier pour un nouveau wiki qui inclura des composants orientés serveurtiddlywiki monnouveauwiki --serverpour démarrer TiddlyWiki- Positionnez votre navigateur sur l'adresse http://127.0.0.1:8080/
- Essayez d'éditer et de créer de nouveaux tiddlers
L'option -g demande à Node.js d'installer TiddlyWiki globalement. Sans elle, TiddlyWiki ne sera disponible uniquement dans le répertoire où vous l'avez installé.
TiddlyWiki can also be hosted on online services such as Dropbox and Cloudant.
- Dropbox (syncs the entire HTML file)
- To edit files stored in your Dropbox, go to http://tiny.cc/tw5inthesky/. This will allow you to open any HTML files found.
- Cloudant (or another CouchDB-type server) (syncs individual tiddlers)
- http://noteself.github.io/
Sous Safari, TiddlyWiki ne parvient à sauvegarder les modifications qu'à l'aide de la solution de repli standard : le module de sauvegarde compatible HTML5.
Cette manière d'enregistrer les modifications est assez pénible, car elle requiert une intervention manuelle à chaque enregistrement.
- Téléchargez un TiddlyWiki en cliquant sur ce bouton :
Si le bouton ne fonctionne pas, enregistrez ce lien : https://tiddlywiki.com/languages/fr-FR/empty.html
Votre navigateur vous demandera peut-être d'accepter explicitement l'enregistrement avant qu'il démarre
- Localisez le fichier que vous venez de télécharger
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
.htmlou.htm
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
- Ouvrez le fichier dans Safari
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Une fenêtre popup Enregistrer les modifications s'affiche, avec un lien ayant pour titre Right-click to save changes
- Cliquez-droit sur le lien et choisissez "Télécharger le fichier lié sous..." à partir du menu contextuel
- Naviguez jusqu'au dossier contenant le fichier HTML de votre wiki, et sélectionnez le fichier existant
- Cliquez sur le bouton Enregistrer
- Cliquez sur Remplacer pour confirmer que vous souhaitez remplacer le fichier existant
- Vérifiez que vos modifications ont été correctement enregistrées en ouvrant à nouveau le fichier.
GitHub est une société qui propose un service d'hébergement de code incluant des fonctions collaboratives puissantes.
Le code et la documentation de TiddlyWiki est hébergé sur GitHub à l'adresse :
| en-GB | fr-FR | Commentaire |
| added | ajouté | |
| background | arrière plan | |
| bug | bogue | |
| core | noyau | |
| draft | ébauche | |
| empty édition | édition basique | |
| encryption | cryptage | |
| fixed | corrigé | |
| flexible | souple | maléable |
| improved | amélioré | |
| introduce | intègrer | ex (eng) : Introduce plugin |
| keyword | motclé | |
| layout | mise en page | |
| lazy loading | téléconsigne | |
| no * | sauf * | hormis * |
| non-linear | 3D ? | |
| placeholder | zoneréservée | |
| pull request | proposer une contribution | |
| run | séquence | |
| SafeMode | ModeSansÉchec | ModeSecours ? |
| SandBox | BacàSable | => ZoneBrouillon/Protégée ? |
| sequence | suite /série | |
| a set | un ensemble | |
| shadow | shadow | (ombre, *latent*, fantôme ?) |
| snippet | portion | |
| step | étape | |
| story river | déroulé | |
| tagging | étiquet(er/age) | tag=> tag/étiquette |
| template | gabarit | |
| tweak | régl(er/age) | |
| upgrade | mettre à niveau | actualiser/Obtenir la dernière version |
| view | visualisation | abr. : 'Visu' |
| Whitespace | Espacevierge | |
| widget | widget |
AVERTISSEMENT - Mots et références réservés pour le système :
- Les noms de
champet leurs références (nom du champ sans séparateur suivi de Field, ex : ListField) - Les noms des widgets, ex : NavigatorWidget
Les onglets suivants du menu latéral offrent un exemple de listes groupées créées par imbrication.
Option 'types' (de l'onglet plus)
Pour l'option Types, la sortie de liste filtrée sélectionne chaque valeur trouvée dans le champ type, comme exposé çi-dessous. Le filtre d'entrée filtre les tiddlers (non-système) de ce type.
<$list filter={{$:/core/Filters/TypedTiddlers!!filter}}>
<div class="tc-menu-list-item">
<$view field="type"/>
<$list filter="[type{!!type}!is[system]sort[title]]">
<div class="tc-menu-list-subitem">
<$link to={{!!title}}><$view field="title"/></$link>
</div>
</$list>
</div>
</$list>
Onglet 'récent'
Dans l'onglet Récent la liste est générée en utilisant la macro timeline. Ici, la sortie de liste filtre chaque jour trouvé dans le champ modifié, tandis que l'entrée de liste filtre tous les tiddlers datés du même jour dans le champ modifié.
\define timeline-title()
<!-- Override this macro with a global macro
of the same name if you need to change
how titles are displayed on the timeline
-->
<$view field="title"/>
\end
\define timeline(limit:"100",format:"DDth MMM YYYY",subfilter:"",dateField:"modified")
<div class="tc-timeline">
<$list filter="[!is[system]$subfilter$has[$dateField$]!sort[$dateField$]limit[$limit$]eachday[$dateField$]]">
<div class="tc-menu-list-item">
<$view field="$dateField$" format="date" template="$format$"/>
<$list filter="[sameday:$dateField${!!$dateField$}!is[system]$subfilter$!sort[$dateField$]]">
<div class="tc-menu-list-subitem">
<$link to={{!!title}}>
<<timeline-title>>
</$link>
</div>
</$list>
</div>
</$list>
</div>
\end
Une étape majeure dans la croissance de TiddlyWiki fut la création de GTDTiddlyWiki par Nathan Bowers. Il partit du TiddlyWiki de base et l'adapta spécifiquement pour la gestion et le suivi de tâches à l'aide de la méthodologie bien connue Getting Things Done. GTDTiddlyWiki fut un succès immédiat, salué avec enthousiasme par des sites comme LifeHacker.
Dans les années qui suivirent, TiddlyWiki continua à croître en popularité, et s'enrichit de nouvelles fonctions et possibilités. En un an, je pus trouver une indépendance financière en proposant du développement sur mesure autour de TiddlyWiki, notamment en travaillant avec un pionnier du wiki, SocialText, sur la possibilité de synchroniser des modifications avec un serveur en ligne.
TiddlyWiki makes a great GuerillaWiki in situations where it is not practical to use a traditional wiki.
For instance, in a corporate setting, persuading an over-worked IT department to install a Wiki server for you is seldom going to be possible overnight. And if your PC is locked down you can't install a conventional Wiki yourself. Equally, you can't go and use one of the public hosted Wiki services because your Information Security department would not allow all that corporate data to flow into an outside server.
TiddlyWiki slices through those barriers by being usable on virtually all PCs.
Le traitement habituel des paragraphes en WikiTexte implique que les retours à la ligne simples sont ignorés, tandis que deux retours à la ligne sont interprétés comme la fin d'un paragraphe.
Ce comportement n'est pas pratique pour du texte qui intègre des retours à la ligne – par exemple, pour de la poésie.
Syntaxe en bloc
Un bloc de contenu délimité par trois caractères "guillemets doubles" """ permet d'indiquer que les fins de ligne doivent y être forcées :
"""
Ceci est une ligne
et ceci est une nouvelle ligne
tandis que cela est encore une autre ligne
et ceci est la dernière
excepté celle-ci
"""- Remarque
- Contrairement à d'autres syntaxes en bloc, celle-ci ne requière pas que ses marqueurs soient seuls sur une ligne : ils pourraient être placés n'importe où, même au milieu du texte.
Syntaxe HTML
Les fins de lignes ne devraient pas être forcées dans un texte courant, car cela peut déformer l'affichage sur des terminaux mobiles.
Cependant, dans des cas exceptionnels, la balise HTML <br> peut être utilisée pour revenir à la ligne sans créer de nouveau paragraphe :
Ceci est une première ligne.<br>
Ceci est une deuxième ligne.<br>Et cela est une troisième ligne.- Remarque
- Plusieurs
<br>d'affilée permettent de créer artificiellement un espacement de plusieurs lignes.
Since TiddlyWiki Version 5.1.16, it's possible to apply customs styles with data- attributes. see: How to apply custom styles
The Custom data-styles stylesheet tiddler contains the following definition:
[data-tags*="example-hardlinebreaks"] .tc-tiddler-body {
word-break: normal;
word-wrap: break-word;
white-space: pre-wrap;
}If rendered without the tag, the content of "Hard Linebreaks with CSS - Example" will be shown like this:
The following text is rendered without any special WikiText syntax. So most of the WikiText functionality will be accessible. This is a line and this is a new line while this is yet another line and this is the final one apart from this one
Open the tiddler to see the custom CSS rules applied: Hard Linebreaks with CSS - Example
The following text is rendered without any special WikiText syntax. So most of the WikiText functionality will be accessible.
This is a line and this is a new line while this is yet another line and this is the final one apart from this one
| purpose | filter the input by field existence |
|---|---|
| input | a selection of titles |
| suffix | F = New in: 5.1.14 optionally, the name of a field |
| parameter | F = the name of a field |
| output | without suffix or with suffix value» those input tiddlers in which field F has a non-empty valuesuffix field» those input tiddlers in which field F exists |
! output | without suffix or with suffix value» those input tiddlers in which field F does not exist or has an empty valuesuffix field» those input tiddlers in which field F does not exist |
[has[color]]
[tag[Concepts]!has[modified]]
[has:field[emptyfield]]
[all[current]!has:field[doesntexist]]
| purpose | filter the input by tiddler modification status |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | those input tiddlers that have been modified during this session |
! output | those input tiddlers that have not been modified during this session |
A tiddler is deemed to have been modified if it has been written back to the wiki since the start of the current TiddlyWiki session. If you edit a tiddler and immediately store it again without making any changes, that is enough to mark it as modified.
Un ou plusieurs caractères "point d'exclamation" ! au début d'une ligne signalent un titre de rubrique :
! Titre de niveau 1
!! Titre de niveau 2
!!! Titre de niveau 3
!!!! Titre de niveau 4
!!!!! Titre de niveau 5
!!!!!! Titre de niveau 6Des styles et des classes CSS peuvent être assignés individuellement aux titres :
!! Titre
!!@@background-color:#00ffff; Titre stylisé@@
!!.monStyle Titre stylisé avec une classeN'avez-vous jamais eu la sensation que votre tête était trop petite pour contenir tout ce dont vous avez besoin de mémoriser ?
Bienvenue sur TiddlyWiki, un carnet de notes web non-linéaire pour saisir, organiser et partager des informations simples ou complexes.
Utilisez-le pour gérer votre liste de tâches, faire le plan d'un essai ou d'une nouvelle, ou pour organiser votre mariage. Enregistrez tout ce qui vous traverse l'esprit, ou construisez un site web flexible et réactif.
Introduction à TiddlyWiki
Un mini-guide
Quoi de neuf dans 5.1.20-prerelease
TiddlyMap Plugin
Aider TiddlyWiki
Développeurs
TiddlyWiki Classique
Contrairement aux services en ligne classiques, TiddlyWiki vous permet de choisir où conserver vos informations , et garantit que, dans les décennies à venir, vous pourrez toujours utiliser les notes que vous prenez aujourd'hui.
Affiche un texte d'aide sur une commande particulière :
--help [<commande>]Si aucun nom de commande n'est fourni, affiche la liste de toutes les commandes disponibles.
Si vous appréciez l'utilité de TiddlyWiki, il y a plusieurs façons d'aider à l'améliorer et à assurer son avenir.
Former et Promouvoir
Les Projets OpenSource comme << tw >> prospèrent grâce aux réactions et à l'engagement des utilisateurs. Plus TiddlyWiki deviendra d'autant plus utile à tous que nous serons de plus en plus nombreux à l'utiliser. Aussi, Si vous appréciez l'utilité de TiddlyWiki, faites le savoir. Le meilleur moyen de garantir son avenir est de devenir des centaines de fois plus populaire qu'auparavant.
- Tweeter sur TiddlyWiki: I love TiddlyWiki because...
- Etoiler le référentiel TiddlyWiki5 sur GitHub
- Afficher la bannière TiddlyWiki
Aider à améliorer le code et la documentation
Vous pouvez contribuer à TiddlyWiki de plusieurs façons :
- Rédiger des didacticiels
- Contribuer à la documentation sur tiddlywiki.com
- Réaliser des vidéocaptures d'écran
- Relever les liens, trucs et astuces pertinents au sein d'un wiki
Le code et la documentation principal de TiddlyWiki se trouvent sur GitHub, où sont accueillies les différentes contributions:
New in: 5.1.19 When saving a TiddlyWiki using the button, the default file name used for saving is constructed using the Title of the TiddlyWiki as entered in the Control Panel, which is stored in the tiddler $:/SiteTitle.
The value used is in the form {{$:/SiteTitle}}.html. This causes the filename to be constructed from the site Title with a .html extension.
If a tiddler named $:/config/SaveWikiButton/Filename is created, the text in that tiddler will be used as the default file name used for saving the TiddlyWiki.
By default new images are created with the image-type jpeg
The hidden setting in $:/config/NewImageType can be set to another Image-Type which is used for new Image Tiddlers, like png
As part of navigating to a tiddler, TiddlyWiki scrolls the page so that the top of the tiddler lines up with the top of the browser window. This means that the upper part of tiddlers can be obscured when using custom position:fixed toolbars at the top of the window.
To adjust the scroll position to allow for the toolbar, add the CSS class tc-adjust-top-of-scroll to the toolbar. TiddlyWiki's scrolling mechanism will then dynamically adjust the scroll position by the height of that element.
When TiddlyWiki first opens in the browser the search box is automatically given the focus by default. If this causes problems, you can change the default by changing this value from true to false:
New in: 5.1.14 Controls the minimum length of a search string before results are displayed.
Defaults to "3".
New in: 5.1.16 Tag Dropdown: Controls the minimum length of an input string before results are displayed.
Defaults to "0".
Determines the template used when saving via the "save wiki" page control button.
Defaults to $:/core/save/all.
You can change this setting to choose what is saved when the "save wiki" button is clicked.
TiddlyWiki defers processing changes to draft tiddlers until a timeout has elapsed. The default value of 400ms gives a good balance of responsiveness in most cases but isn't always optimal on lower powered mobile devices.
The timeout can now be changed by changing this value (in milliseconds):
The most useful configuration settings for TiddlyWiki are exposed in the control panel but some more advanced settings do not have a full user interface. Instead, the underlying configuration tiddlers are edited directly.
To change these settings on an empty TiddlyWiki, you can drag the links to the individual configuration tiddlers directly from this wiki into yours.
Ce plugin propose la coloration syntaxique.
Il s'agit de réflexions personnelles sur l'histoire et le développement de TiddlyWiki, par son créateur JeremyRuston.
En 1997, un collègue me montra le wiki original de Ward Cunningham. Que quelque chose d'aussi puissant puisse être écrit en seulement 700 lignes de Perl m'impressionna à l'époque, et j'étais aussi fasciné par la manière radicale dont la sécurité et le système de permissions avaient été repensés. Comme beaucoup d'autres développeurs, je me suis jeté sur tous les types de wiki qui me passaient sous la main, afin d'explorer leur utilisation en environnement de travail.
Le principal attrait du wiki pour moi était le sentiment qu'il pouvait remettre en question le paradigme qui prévalait jusqu'alors, à savoir les documents conçus pour être imprimés, et les emails.
Après avoir observé pendant quelques années la manière dont les gens utilisaient les wikis, j'ai remarqué que les utilisateurs avancés faisait grand usage de la possibilité d'ouvrir plusieurs pages de wiki à la fois dans les onglets de leur navigateur, pour se faciliter la comparaison et la révision des pages, la recopie de texte d'une page à l'autre, et pour se constituer une sorte de file de pages en attente d'être lues.
J'ai eu le sentiment que cette capacité à manipuler plusieurs pages en même temps était centrale dans la capacité à réorganiser un wiki, et on considère généralement qu'un wiki réorganisé avec amour a tendance à être plus utile. Pourtant, les interfaces utilisateur des wiki ont toujours été exclusivement conçues pour la présentation et la manipulation d'une seule page à la fois.
Toutes ces réflexions se sont synthétisées lorsque j'ai vu l'interface de Gmail en avril 2004, qui utilisait Ajax de manière ingénieuse pour assembler des mails individuels dans des fils de conversations.
J'ai commencer à expérimenter avec HTML et JavaScript pour pousser l'idée. Je n'avais eu jusqu'à présent pratiquement aucune expérience de l'un ou de l'autre, à part composer quelques pages statiques et des sites ASP simples dans des vies précédentes. Se plonger dans ces techniques orientées client a été une expérience douloureuse ; comme tout le monde, j'étais horrifié de découvrir l'atrocité des incompatibilités et incohériences de la programmation web.
Lancement de TiddlyWiki
En septembre 2004, j'ai donc publié une version préliminaire de TiddlyWiki. Il s'agissait de la plus petite application possible démontrant le concept : un simple fichier HTML de 48KB qui s'auto-engendrait.
L'inconvénient d'avoir écrit de cette manière la première version de TiddlyWiki, c'est que ça la rendait complètement impraticable pour l'édition — quand vous cliquiez sur « enregistrer les modifications », elle faisait apparaître une fenêtre montrant les données qui auraient été enregistrées s'il avait été possible d'écrire sur le système de fichiers depuis une page HTML.
Un grande partie des premiers commentaires sur TiddlyWiki étaient que c'était un outil sympathique, mais qu'il aurait été plus utile si on avait pu enregistrer correctement les modifications. J'étais plutôt frustré, car je tenais pour certaine l'impossibilité pour un fichier HTML tournant dans un navigateur d'enregistrer des modifications sur le système de fichiers local.
Quelques mois plus tard, j'ai repéré une extension Firefox expérimentale qui permettait à TiddlyWiki de sauvegarder les modifications depuis le navigateur. En examinant le code, je réalisai que l'API utilisée pour écrire sur le système de fichiers était en fait disponible pour les fichiers HTML ordinaires — pourvu qu'ils soient chargés depuis une URI de type file://.
J'adaptai le code Firefox dans le noyau de TiddlyWiki et j'ajoutai bientôt une fonctionnalité similaire pour Internet Explorer (en utilisant un ancien contrôle ActiveX que Microsoft distribuait avec Internet Explorer).
Croissance de TiddlyWiki
Une étape majeure dans la croissance de TiddlyWiki fut la création de GTDTiddlyWiki par Nathan Bowers. Il partit du TiddlyWiki de base et l'adapta spécifiquement pour la gestion et le suivi de tâches à l'aide de la méthodologie bien connue Getting Things Done. GTDTiddlyWiki fut un succès immédiat, salué avec enthousiasme par des sites comme LifeHacker.
Dans les années qui suivirent, TiddlyWiki continua à croître en popularité, et s'enrichit de nouvelles fonctions et possibilités. En un an, je pus trouver une indépendance financière en proposant du développement sur mesure autour de TiddlyWiki, notamment en travaillant avec un pionnier du wiki, SocialText, sur la possibilité de synchroniser des modifications avec un serveur en ligne.
Acquisition par British Telecom
En mai 2007, British Telecom a acquis Osmosoft, ma société de consultant. Acquérir une société avec un seul employé et un minuscule filet de revenu relevait d'une décision inhabituelle, Osmosoft ne détenant même pas la propriété intellectuelle de TiddlyWiki, puisque je l'avais transférée à UnaMesa pour assurer son avenir pour la communauté.
La motivation de British Telecom était de mieux comprendre les écosystèmes basés sur les communautés. Je rejoignis la société en tant que « Head of Open Source Innovation », responsable de la gouvernance open source, et fournissant des conseils et de l'expertise sur la manière de participer à des communautés open source.
Osmosoft et TiddlySpace
Je constituais une équipe chez BT sous le nom Osmosoft. Nous avions comme objectif d'évangéliser les bénéfices de l'open source et d'aider d'autres équipes à réaliser ces bénéfices en pratique. Nous nous sommes aussi rendu compte qu'il était nécessaire d'évangéliser l'usage du Web en général, et les standards web en particullier.
Notre approche était de privilégier la démonstration sur le discours. Nous avons travaillé avec la communauté TiddlyWiki pour étendre l'écosystème, et nous avons construit de nombreux systèmes internes pour BT (certains basés sur TiddlyWiki, d'autres non).
La principale contribution d'Osmosoft à la communauté TiddlyWiki fut la création de TiddlyWeb et TiddlySpace. TiddlyWeb était un serveur robuste, capable de servir des tiddlers sur l'Internet, mais aussi de composer des vues TiddlyWiki à partir de ces tiddlers. Quant à TiddlySpace, il s'agissait d'une tentative pour packager TiddlyWeb de façon plus directement utilisable.
Départ de British Telecom
Fin 2011, j'ai progressivement senti que j'aurais plus de latitude hors de l'enceinte de British Telecom pour réaliser le potentiel de TiddlyWiki. D'un commun accord, je suis parti et j'ai commencé à travailler comme développeur indépendant, en me concentrant principalement sur une réincarnation de TiddlyWiki, qui pris la forme de TiddlyWiki5.
Développement de TiddlyWiki5
J'ai travaillé sur une nouvelle version de TiddlyWiki à partir de novembre 2011. En tant que programmeur, travailler à une « version 2.0 » de quelque chose que j'avais déjà écrit était une projet très séduisant. Cela signifiait que les besoins étaient bien compris, et je pouvais dès lors me concentrer sur l'architecture et ses évolutions nécessaires à la mise en œuvre des fonctionnalités désirées.
L'avenir
À présent que TiddlyWiki5 a enfin quitté son statut de « beta », j'ai bon espoir qu'il vivra longtemps. Comme il n'utilise que des fonctionnalités standard de HTML5 et Node.js, il n'y a aucune raison pour qu'il ne reste pas entièrement opérationnel dans les années qui viennent. Mon but est qu'il survive au moins 25 ans.
Le tiddler système $:/HistoryList garde la trace d'une liste de tiddlers composé de l'historique de navigation. Chaque fois que vous cliquez sur un lien vers un tiddler, le titre du tiddler cible est ajouté au sommet de la pile.
La liste historique est mémorisée en JSON qui permettent des détails additionnels au sujet des coordonnées du nœud DOM initialisant la navigation. Ce champ peut être utilisé comme suit :
<$list filter="[list[$:/StoryList]]" history="$:/HistoryList" storyview="pop">
<$button message="tm-close-tiddler" class="tc-btn-invisible tc-btn-mini">×</$button> <$link to={{!!title}}><$view field="title"/> <$reveal type="match" state="$:/HistoryList!!current-tiddler" text=<<currentTiddler>>>✓</$reveal></$link>
</$list>ce qui affichera de façon semblable à l'onglet "Ouvert" du menu latéral, avec en sus, une coche contre le tiddler objet de la dernière navigation.
Déroulé vide
Pour afficher un contenu lorsque le déroulé est vide, créez un $:/config/EmptyStoryMessage et entrez le contenu souhaité. Le cas suivant montrerait le tiddler GettingStarted quand tous les autres sont fermés.
{{GettingStarted||$:/core/ui/ViewTemplate}}Une ligne horizontale se crée avec trois caractères "moins" ou plus ---, seuls sur une ligne :
Paragraphe précédent.
---
Paragraphe suivant.- Remarque
- La ligne vide avant la ligne horizontale est nécessaire pour que cette dernière soit interprétée correctement, et non comme un tiret.
Lorsque vous éditez un tiddler sur https://tiddlywiki.com, vous voyez un petit bandeau qui vous invite à éditer la source du tiddler sur GitHub.
Si vous utilisez Node.js, vous pouvez répliquer cette fonction pour votre propre site basé sur TiddlyWiki de la manière suivante :
- Assurez-vous que la configuration suivante est incluse dans le fichier
tiddlywiki.infode votre dossier TiddlyWiki"config": { "retain-original-tiddler-path": true } - Copiez le tiddler $:/ContributionBanner vers votre wiki
- Effectuez les changements suivants :
- Ajuster le lien GitHub https://github.com/Jermolene/TiddlyWiki5/edit/master/editions/tw5.com/tiddlers/ pour le faire pointer vers votre propre répertoire GitHub.
- Assurez-vous que le texte commençant par "Can you help us improve this documentation?" est approprié pour vos visiteurs
- Remplacez le lien vers Améliorer la documentation de TiddlyWiki par un lien vers le tiddler qui contient vos instructions pour votre propre procédure de contributions.
Pour créer un nouvel onglet dans le menu latéral :
- Créez un tiddler et étiquetez-le avec le tag système $:/tags/SideBar
- Si vous souhaitez créer un onglet de table des matières, vous pouvez peupler ce nouveau tiddler à l'aide de la Macro TableOfContents. Regardez par exemple comment fonctionne Table des matières
- Par défault, libellé de l'onglet correspond au titre du tiddler, mais vous pouvez le remplacer en remplissant le champ
caption. - Pour définir l'ordre des onglets, servez-vous des champs
list-afteroulist-before, comme expliqué dans Étiquetez par tags- Par exemple : donnez à
list-afterla valeur $:/core/ui/SideBar/Open pour placer un onglet de barre latérale juste après l'onglet « Open » (Ouverts)
- Par exemple : donnez à
Notez qu'il est possible de créer de la même manière de nouveaux onglets sous l'onglet
« More » (Plus), en utilisant le tag $:/tags/MoreSideBar.
At the moment there are several ways to apply custom styles.
Vous pouvez appliquer des styles personnalisés aux tiddlers ayant un tag particulier en définissant une classe CSS nommée tc-tagged-<Nom du tag>.
Par exemple, pour coloriser les tiddlers étiquetés "NightReader" d'une façon spéciale, Créer une feuille de style définissant la classe tc-tagged-NightReader comme suit :
.tc-tagged-NightReader {
background-color:black;
color: orange;
padding: 35px 35px;
}
.tc-tagged-NightReader .tc-tiddler-body {
font-size: 1.5em;
}La classe tc-tagged-NightReader s'applique au tiddler tou entier et pas seulement au texte du tiddler. Si vous désirez l'appliquer à une portion plus réduite du tiddler vous pouvez ajuster le sélecteur CSS, comme ici avec .tc-tagged-NightReader .tc-tiddler-body.
Notez que les tags contenant des espaces et des caractères non-alphanumériques seront convertis en utilisant le codage URI, rendant le nom de classe CSS généré difficile à prévoir. Par exemple :
| Tag | Nom généré pour la classe |
|---|---|
$:/mytag | tc-tagged-%24%3A%2Fmytag |
one two | tc-tagged-one%20two |
£35.23 | tc-tagged-%C2%A335.23 |
Commencez par installer TiddlyWiki comme indiqué dans Installer TiddlyWiki sur Node.js.
- Créez un dossier TiddlyWiki vide
- Le plus simple pour ce faire est d'utiliser la commande init :
tiddlywiki ~/MonDossierWiki --init empty - Vous pouvez aussi vous contenter de copier le dossier
editions/emptyà partir du répertoire source TiddlyWiki5 - Ou encore, ex-nihilo :
- Créez un nouveau dossier dans un endroit pratique (par exemple
~/MonDossierWiki) - Créez un fichier appelé
tiddlywiki.infocontenant le texte ci-dessous :{"themes": ["tiddlywiki/vanilla","tiddlywiki/snowwhite"]}
- Créez un sous-dossier appelé
tiddlers
- Créez un nouveau dossier dans un endroit pratique (par exemple
- Le plus simple pour ce faire est d'utiliser la commande init :
- Ajoutez des fichiers de tiddlers individuels dans le répertoire
~/MonDossierWiki/tiddlers - Exécutez la commande ci-dessous depuis le répertoire racine de TiddlyWiki5 pour construire un fichier TiddlyWiki5 complet à partir des tiddlers :
tiddlywiki ~/MonDossierWiki --rendertiddler $:/core/save/all index.html text/plain
Imagine that you are using a Table of Contents macro similar to this:
<<toc-selective-expandable "TableOfContents" "sort[title]" >>The sorting is fine for most cases, but you would like all your items tagged Journal to be sorted by the created field. How can you apply a separate sort order to just those sub-items tagged Journal?
The trick is to add a field to the parent tagging tiddler (i.e. Journal) that points to a different sort criteria. Let's call the field fuzzy, and populate it with the value created (created is the name of the field that contains a tiddler's creation date).
Now change your Table of Contents to look like this:
<<toc-selective-expandable "TableOfContents" "sort{fuzzy}" >>Now your Table of Contents will sort by title everywhere, except for the children of the Journal tiddler, which will sort by the created date.
The downside to this trick is that you can't apply a reverse sort based on just one special field. If you reverse the sort order, it will be reversed everywhere.
The configuration mechanism is the same for both shortcut-types
A tiddler with the prefix $:/config/ShortcutInfo/ and a unique suffix appended, like my-shortcut, makes the new shortcut appear in the $:/ControlPanel within the Keyboard Shortcuts Tab. An optional description can be added within its text field
In the Keyboard Shortcuts Tab the key combination that should trigger the shortcut can be configured:
Look for the unique suffix defined for the new shortcut and click the button to open a popup that detects key combinations and shows the detected combination in its input field
The add shortcut assigns the key-combination to the shortcut
Depending on the chosen platform the configuration mechanism creates a tiddler with a specific nomenclature
$:/config/shortcuts/ + the shortcut suffix for shortcuts that will work on all platforms (operating systems)
$:/config/shortcuts-(mac/not-mac/windows/not-windows/linux/not-linux)/ + the shortcut suffix for shortcuts that will work on the chosen platform only or that will not work on the excluded platform
Examples
- $:/config/shortcuts/
my-shortcut - $:/config/shortcuts-mac/
my-shortcut - $:/config/shortcuts-windows/
my-shortcut - $:/config/shortcuts-linux/
my-shortcut - $:/config/shortcuts-not-mac/
my-shortcut - $:/config/shortcuts-not-windows/
my-shortcut - $:/config/shortcuts-not-linux/
my-shortcut
At this point the shortcut is defined and its actions can be configured
Using the Keyboard Widget
A
$keyboardwidget detects the key combinations pressed within aninputortextareafield within its scope. The$keyboardwidget needs to "embrace" theinputortextareafield and itskeyattribute either points to a configuration tiddler using the Key Descriptor Syntax or explicitely contains the key
<$keyboard key="((my-shortcut))" actions='<$action-setfield $tiddler="my-tiddler" $field="my-field" $value="my-value"/>'>
<$edit-text tag="input" tiddler="my-tiddler"/>
</$keyboard><$keyboard key="alt-shift-M" actions='<$action-setfield $tiddler="my-tiddler" $field="my-field" $value="my-value"/>'>
<$edit-text tag="input" tiddler="my-tiddler"/>
</$keyboard>If actions are defined , the
$keyboardwidget will invoke the actions defined in itsactionsattribute when it detects the key-combination defined in itskeyattribute being pressed in anyinputortextareafield within its scope
Using global Keyboard Shortcuts
The actions for global keyboard shortcuts are stored in the text field of tiddlers tagged with
The key field connects an action-tiddler with the corresponding shortcut through the
((my-shortcut))syntax, called Keyboard Shortcut Descriptor
Syntax:
((+a chosen suffix+))
If the tiddler has the tag , the field key with the Keyboard Shortcut Descriptor as its value and some actions in its text field, the actions will be triggered when the mechanism detects the configured key-combination
\import $:/core/ui/PageMacros [all[shadows+tiddlers]tag[$:/tags/Macro]!has[draft.of]]
If the tiddler that contains the macro definition is known and - for example - titled my-macro-tiddler
\import my-macro-tiddler
Widgets
$action-navigate (ActionNavigateWidget)
Messages
WidgetMessage: tm-cancel-tiddler
WidgetMessage: tm-close-all-tiddlers
WidgetMessage: tm-close-other-tiddlers
WidgetMessage: tm-close-tiddler
WidgetMessage: tm-delete-tiddler
WidgetMessage: tm-edit-tiddler
WidgetMessage: tm-import-tiddlers
WidgetMessage: tm-new-tiddler
WidgetMessage: tm-perform-import
WidgetMessage: tm-save-tiddler
Prelude/caution:
Before experimenting with TiddlyDesktop internals you should find the location of the “user configuration folder” - click the “Settings” button on the main TiddlyDesktop window, and then click the button “Open user config folder”. Then move up to locate the parent folder, which should be called “TiddlyDesktop”. If things go wrong, you can reset TiddlyDesktop to its factory state by deleting this entire folder.
Click the Backstage button on the main TiddlyDesktop window to open the backstage wiki. This is is a Node.js-like instance of TiddlyWiki that runs the UI and logic of TiddlyDesktop.
How do I get rid of the "Add a TiddlyWiki Folder" button.
Within the backstage wiki, locate the tiddler WikiListToolbar (there’s a link in HelloThere). Click it into edit mode and you’ll see the wikitext for all the toolbar buttons. If you make modifications and click “done” then the changes will immediately be reflected in the main TiddlyDesktop window.
How would I change the "advanced" button to the "reveal backups" button.
You can copy the code for the “reveal backups” button from the tiddler $:/TiddlyDesktop/Settings and paste it into WikiListToolbar.
How do I change the colors?
Just as usual in TiddlyWiki: you can use the palette, or define your own custom CSS.
How do I change the order in which the tiddlers are listed (which appears to be alphabetical)?
Open the WikiList tiddler, edit it, and scroll to the end. Then change the <$list> widget inside the wikilist macro:
<$list filter="[tag[wikilist]sort[title]!has[draft.of]]" emptyMessage="Add a ~TiddlyWiki file or folder to get started. Click the buttons above to browse, or drag and drop from your file Explorer/Finder" storyview="pop">Note about embedding versus external linking
Note: Before we dive into how you can embed files of a certain type, you may want to consider not embedding and instead simply linking to external resources like this:
[ext[title|path/to/that.file]] Then let your browser decide how to handle the resource. The advantage to this approach is that it is simple and quick. The disadvantage is that the file doesn't actually travel with the TW5 file and that you can't use node.js with method #2 below to quickly file paths.
Two ways to embed a PDF in your TW5 file.
1. Embedding with Drag and Drop
One is to drag and drop the file onto your TW5 file. Wait for the green bar to appear at the top, drop, and then import from the import tiddler. This actually embeds the contents of your imported PDF (or other file) into your TW5 file.
This method be OK as long as your PDF is not too big. There can be concerns if your TW5 file becomes too big.
2. Embedding with '_canonical_uri'
The other way is to create a tiddler link to the external file. In this method the file is not actually incorporated into your TW5 file, but can be accessed with the {{My Image File.jpg}} transclusion syntax just like an embedded file. The location address of the file can also be changed under node.js. See ExternalImages for details of using external images with node.js.
Create a tiddler with a field _canonical_uri. Put in the local address to the external file. Set the type field to application/pdf.
With either way, with an appropriately configured browser, you should see your embedded PDF file.
Other File Types
There's only so many file formats that TW5 knows about. There is a list at ContentType. If your browser and/or TW5 doesn't know what to do with a particular file format, then you can only the use the second method to embed and then download a file. When you edit the tiddler a link is presented. You can right click on the link in order to download the file.
Selecting All tiddlers for export
To export all tiddlers click on the "Tools" tab of the Sidebar. Find and click the export all button. A pop-up menu will offer you the chance to export tiddlers in multiple formats.
Exporting a tiddler
If you want to export a particular tiddler, first navigate to that tiddler. Then click on the more button that appears above the tiddler. From the list that appears select export tiddler. A pop-up menu will offer you the chance to export the tiddler in multiple formats.
Exporting tiddlers matching a criteria (filter)
To export a selection of tiddlers, click the little magnifying glass next to the search area on the sidebar. This will open the Advanced Search tiddler. Click on the "Filter" tab of the Advanced Search tiddler. Only the Filter tab will allow you to export a selection of tiddlers. Filters follow a particular syntax. Click on this Filters link to learn about how to make filters.
Once you have written a filter, a list of tiddlers matching the filter will appear. Now you can click on the export tiddler button to the right of the filter input field. A pop-up menu will offer you the chance to export tiddlers in multiple formats.
Export formats
Currently, the export formats available are:
- CSV file format
- JSON file format
- Static HTML file
- ".tid" file format
The ".tid" format is unique from the other formats in that only one tiddler will be exported, even if you are attempting to export all tiddlers or a selection of tiddlers.
Sometimes you might want to save some screen space by hiding away the author's name in all tiddlers. Here's a quick way to do it:
- Create a new tiddler with any title you want.
- Give the tiddler the tag
$:/tags/Stylesheet - In the text field of the tiddler put:
.tc-subtitle .tc-tiddlylink {display:none;}- Save the tiddler. The author's name field should no longer appear.
Similarly, the entire subtitle field including author and date can be removed with:
.tc-subtitle {display:none;}Unfortunately, you can't hide just the date without also hiding the author using CSS.
And finally, for a truly minimalist look, you can remove the title with:
h2.tc-title {display:none;)Voici comment afficher la date de la dernière modification dans une bannière du wiki dans un coin de la fenêtre :
- Copiez le plugin $:/plugins/tiddlywiki/github-fork-ribbon dans votre TiddlyWiki
- Sauvegardez et rechargez votre wiki
- Créez un nouveau tiddler appelé $:/_MyRibbon étiqueté $:/tags/PageControls et contenant :
<div class="github-fork-ribbon-wrapper right"> <div class="github-fork-ribbon" style="background-color:#DF4848;"> <$list filter="[!is[system]!has[draft.of]!sort[modified]limit[1]]"> <$link> <$view field="modified" format="date" template="DD mmm YYYY at 0hh:0mm"/> </$link> </$list> </div> </div> - Si nécessaire, modifier la valeur background-color à votre convenance
- Vous pouvez aussi essayer de modifier le positionnement de la classe de
rightàright-bottom- Pour faire apparaitre la bannière dans le coins supérieur gauche vous devrez étiqueter le $:/tags/PageTemplate au lieu de $:/tags/PageControls et changer la position de la classe à
left
- Pour faire apparaitre la bannière dans le coins supérieur gauche vous devrez étiqueter le $:/tags/PageTemplate au lieu de $:/tags/PageControls et changer la position de la classe à
CamelCase is used in most Wikis, but it can interfere with text presentation in some situations.
Turning off Camel Case locally
To turn off a particular instance of a CamelCase text, simply put a tilde (~) in front of the word, like this:
~CamelCaseTurning off Camel Case globally
To turn off CamelCase in all tiddlers, navigate to the Control Panel. Select the Settings tab and then scroll or read down to the Camel Case Wiki Links section and unselect Enable automatic CamelCase linking.
You can change the width of the main column of tiddlers (also known as the story river) by:
- Clicking on the settings cog to open the control panel
- In the control panel select "Appearance" and then "Theme Tweaks".
- Under Theme tweaks, scroll down.
There you will see settings for story right, story width, and tiddler width. By setting these numbers to something larger, you can widen the tiddlers. In general, story right and story width should be the same size, and tiddler width a little bit smaller. You could even use percentages for tiddler width. You will also probably want to change the sidebar breakpoint to something larger than the story river, unless you don't mind the sidebar floating to the top of the page.
Les balises HTML (dont les commentaires <!-- -->) peuvent être utilisées directement en WikiTexte :
<article class='hello'>
Ceci est un simple bloc de texte. HelloThere
<!-- Ce commentaire n'apparaîtra pas. -->
</article>- Remarque
- Par conséquent, un mot écrit entre "chevrons"
< >sera interprété comme une balise HTML, ce qui peut entraîner des effets de bord (notamment à cause de l'inexistence de la balise fermante).
À la place, mieux vaut utiliser le code HTML des caractères "chevrons" :<et>
Interprétation du contenu
Par défaut, le contenu d'un élément HTML est interprété en mode texte ("inline mode" en anglais). Cela signifie que les formatages de texte (comme du gras ou un exposant) s'appliquent, mais que les formatages de type bloc (comme les tables, les listes ou les titres) ne sont pas reconnus.
Pour que le contenu de l'élément HTML soit interprété en mode bloc ("block mode" en anglais), il faut faire suivre la balise ouvrante de deux retours à la ligne.
<article class='hello'>
Ceci est du contenu en ''mode texte''.
* Les listes ne sont pas reconnues
-- pas plus que les paragraphes !
</article>
---
<article class='hello'>
Ceci est du contenu en ''mode bloc''.
* Les listes sont reconnues
</article>Attributs
Les attributs d'une balise HTML peuvent être spécifiés littéralement, à l'aide d'une transclusion ou par l'invocation d'une macro :
Par exemple, ici la valeur de l'attribut href sera égale à la valeur du tiddler MonLienDestination :
<a href={{MonLienDestination}}>label du lien</a>Et là, l'attribut est spécifié en invoquant une macro (qui génère elle-même un lien qui peut être paramétré) :
<a href=<<MaMacro "valeur du paramètre">>>label du lien</a>Les valeurs d'attribut littérales peuvent contenir des retours à la ligne (ignoré par le HTML) :
<div data-address="Maison Souris,
3 rue des rongeurs,
Ratville"/>L'utilisation de trois caractères "guillemets doubles" """ permet de spécifier des valeurs d'attributs qui contiennent un seul caractère "guillemet double" :
<div data-address="""Maison "Souris",
3 rue des rongeurs,
Ratville"""/>
It is often useful to be able to create HTML links to external resources. For example, here the value of the href attribute will be set to the value of the tiddler MyLinkDestination:
<a href={{MyLinkDestination}}>link</a>However, there is an unexpected security issue that means that most of the time the link should have the rel attribute set to noopener noreferrer to maintain privacy of the URLs of private TiddlyWiki's (eg on Dropbox). See https://mathiasbynens.github.io/rel-noopener/ for more information.
<a href={{MyLinkDestination}} rel="noopener noreferrer">link</a>The image-picker macro displays an interactive image picker, as can be seen in the core text editor.
Parameters
- actions
- Wikitext for the action widgets that should be executed when the user selects an image. Within the text, the variable
imageTitlecontains the title of the tiddler containing the selected image. - subfilter
- An optional extra filter step, e.g.
tag[MyTag]
The images are selected by means of a filter expression, into which the subfilter parameter is spliced as follows:
[all[shadows+tiddlers]is[image]$subfilter$!has[draft.of]] -[type[application/pdf]] +[sort[title]]
Image: <$edit-text tiddler='$:/_MyImage' tag='input' placeholder='(unset)' default=''/>
<$transclude tiddler={{$:/_MyImage}}/>
---
<$macrocall $name='image-picker' actions="
<$action-setfield $tiddler='$:/_MyImage' $value=<<imageTitle>>/>
"/>This next example shows how the subfilter parameter limits the list of images (here to those with the "Language" prefix):
Image: <$edit-text tiddler='$:/_MyImage' tag='input' placeholder='(unset)' default=''/>
<$transclude tiddler={{$:/_MyImage}}/>
---
<$macrocall $name='image-picker' actions="
<$action-setfield $tiddler='$:/_MyImage' $value=<<imageTitle>>/>
" subfilter="prefix[Language]"/>
Voici un exemple d'utilisation des widgets List et Transclude pour afficher une grille de toutes les images système (autrement dit, les tiddlers tagués avec $:/tags/Image).
Intégration d'image
Les images peuvent être affichées avec WikiText avec la syntaxe suivante, selon que l'image soit déjà incluse dans un tiddler ou pointe vers une source externe :
[img[Sainte Anastasie.png]]
ou [img[https://tiddlywiki.com/favicon.ico]]
ou
Si la source de l'image correspond au titre d'un tiddler, alors le tiddler est affiché directement. Autrement elle est interprétée comme une URL et la balise HTML <img> est générée muni de l'attribut src contenant l'URL.
Une info-bulle, visible au survol par la souris, peut être spécifiée, ainsi que les attributs width (largeur), height (hauteur) et la class :
[img width=80 class="tc-image" [Sculpture époque médiévale - France - Gard - Sainte Anastasie|Sainte Anastasie.png]]
Noter aussi que les attributs peuvent être spécifiés par des transclusions ou des références à des variables:
[img width={{!!mywidth}} class=<<image-classes>> [Sainte Anastasie.png]]La syntaxe d'image est un raccourci d'appel à la fonctionnalité ImageWidget.
Affichage des images par transclusion
Vous pouvez aussi afficher l'image incluse dans un tiddler en transcluant ce tiddler. L'inconvénient de cette méthode est qu'il n'y a alors pas de moyen directe pour contrôler la taille de l'image.
{{Sainte Anastasie.png}}Affichera :
Introduction
The image widget displays images that can be specified as a remote URL or the title of a local tiddler containing the image.
Content and Attributes
Any content of the <$image> widget is ignored.
| Attribute | Description |
|---|---|
| source | The URL of the image, or the title of an image tiddler |
| width | The width of the image |
| height | The height of the image |
| tooltip | The tooltip to be displayed over the image |
| alt | The alternative text to be associated with the image |
| class | CSS classes to be assigned to the <img> element |
The width and the height can be specified as pixel values (eg "23" or "23px") or percentages (eg "23%"). They are both optional; if not provided the browser will use CSS rules to size the image.
External Images and the _canonical_uri field
When used to display tiddler-based images, the image widget operates in two distinct modes:
- If the _canonical_uri field is present then it is used as the src attribute of the generated
<img>element and the text field is ignored - Without the _canonical_uri field, the image widget generates an
<img>element that embeds the image data directly using adata:URI.
See ExternalImages for more details.
Importe des tiddlers depuis des fichiers locaux TiddlyWiki (.html), .tiddler, .tid, .json ou autres. Le désérialiseur doit être spécifié explicitement, à la différence de la commande load qui déduit le désérialiseur à utiliser à partir de l'extension du fichier.
--import <chemin-du-fichier> <désérialiseur> [<titre>] [<encodage>]Les principaux désérialiseurs présents par défaut sont :
- application/javascript
- application/json
- application/x-tiddler
- application/x-tiddler-html-div
- application/x-tiddlers
- text/html
- text/plain
S'il n'est pas spécifié, le titre du tiddler importé a pour valeur le nom du fichier.
L'encodage par défaut est "utf8", mais peut valoir "base64" en cas d'importation des fichiers binaires.
À noter que TiddlyWiki refusera d'importer pas une version plus ancienne d'un plugin déjà chargé.
You can import tiddlers into a TiddlyWiki from external files or directly from another TiddlyWiki.
Importing content from external files
There are several ways to import content from external files:
- Use the import button (under the Tools tab in the sidebar) to select a local file
- Drag and drop files from Windows Explorer or OS X Finder etc. into the TiddlyWiki browser window
- Paste content directly from the clipboard using the menu or keyboard shortcut (ctrl-V or cmd-V)
- Currently supported in Chrome, Firefox and Edge (but not Internet Explorer)
Most files are imported as individual tiddlers. The exceptions are:
- .html files that are recognised as a TiddlyWiki file are parsed to extract the tiddlers within them
- .json files are parsed to extract the tiddlers within them. They can be created by exporting them from another TiddlyWiki. TiddlyWiki accepts JSON files that contain either a single tiddler fields object, or an array of tiddler fields objects
Importing content from other TiddlyWiki browser windows
Tiddlers can be imported from other TiddlyWiki browser windows via Drag and Drop. Drag a tiddler link or tag from one TiddlyWiki browser window to another. Dragging a link will import a single tiddler while dragging a tag pill will import all of the tiddlers that carry that tag.
On peut importer du contenu dans un fichier TiddlyWiki de plusieurs façons :
- En utilisant le bouton importer (sous l'onglet Outils dans la barre latérale, ou dans le Panneau de contrôle) pour choisir un ou plusieurs fichiers locaux ;
- En glissant-déposant des fichiers à partir de l'explorateur Windows ou du Finder Mac OS X sur la fenêtre TiddlyWiki5 du navigateur
- En collant directement le contenu du presse-papier à l'aide du raccourci clavier (contrôle-V ou commande-V)
- Coller depuis le presse-papier n'est pour l'instant possible que dans GoogleChrome
Introduction
The ImportVariablesWidget imports macro and variable definitions from a list of other tiddlers and makes them available to its children. For example:
<$importvariables filter="[tag[mySpecialMacros]]">
All the macros defined in tiddlers with the tag "mySpecialMacros" are available here
</$importvariables>Attributes and Content
The content of the importvariables widget is the scope within which the imported variable definitions are available.
| Attribute | Description |
|---|---|
| filter | Tiddler filter defining the tiddlers from which macro definitions will be imported |
Global Macros
So-called global macros are implemented within the main page template ($:/core/ui/PageTemplate) by wrapping the page content in the following importvariables widget:
<$importvariables filter="[[$:/core/ui/PageMacros]] [all[shadows+tiddlers]tag[$:/tags/Macro]!has[draft.of]]">
...
</$importvariables>\import Pragma
New in: 5.1.18 The \import pragma is an alternative syntax for using the ImportVariablesWidget. For example, the previous example could be expressed as:
\import [[$:/core/ui/PageMacros]] [all[shadows+tiddlers]tag[$:/tags/Macro]!has[draft.of](NB : si vous souhaitez travailler sur la traduction française, reportez-vous plutôt aux infos traducteurs.)
N'importe qui peut proposer des améliorations à la documentation TiddlyWiki présente sur https://tiddlywiki.com :
- Lisez et suivez le Manuel de style pour la documentation TiddlyWiki
- Si vous n'en n'avez pas déjà un, créez un compte sur https://github.com
- Sur https://tiddlywiki.com, cliquez sur le bouton "edit" du tiddler que vous souhaitez améliorer
- Vous devriez voir un bandeau rose avec le texte suivant : Pouvez-vous nous aider à améliorer cette documentation ? Voyez comment éditer ce tiddler sur GitHub.
- Cliquez sur le lien externe ...ce tiddler sur GitHub
- Une alerte va s'afficher comme quoi « you need to fork this repository to propose changes » ( « vous devez cloner ce répertoire avant de pouvoir proposer des modifications »). Un fork est votre propre exemplaire du répertoire, qui intègrera les modifications que vous proposez
- Un nouvel onglet devrait s'ouvrir sur votre navigateur, pour permettre d'éditer le tiddler sur github.com. La dernière vidéo montre le contenu attendu dans cette zone.
- Sous la boîte d'édition du texte du tiddler, vous devriez voir une boîte indiquant Propose file change
- Entrez un titre bref expliquant la modification (par ex., "Clarifier l'instabilité de la syntaxe des attributs")
- Si nécessaire, entrez également une description plus détaillée
- Cliquez sur le bouton vert intitulé Propose file change
- Sur l'écran suivant, cliquez sur le bouton vert intitulé Create pull request
Jermolene ou l'un des autres développeurs principaux sera alors en mesure de fusionner votre pull request de façon à l'intégrer à la prochaine version de https://tiddlywiki.com.
Mario Pietsch a créé pour vous ces tutoriels vidéos :
A plugin that allows changes to be synchronised with the IndexedDB database that is built-in to most browsers.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
| purpose | select all data properties of the input titles |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | all the property names or indices contained in the input data tiddlers |
Each input title is processed in turn, and is ignored if it does not denote a data tiddler. The list of property names is retrieved from the data tiddler (in no particular order) and then dominantly appended to the operator's output.
Where a tiddler's content is JSON with an array as its root, the indexes operator retrieves a selection of integer indices instead.
System tiddlers in the namespace $:/info/ are used to expose information about the system (including the current browser) so that WikiText applications can adapt themselves to available features.
Information Tiddlers
| Title | Description |
|---|---|
| $:/info/browser | Running in the browser? ("yes" or "no") |
| $:/info/browser/screen/width | Screen width in pixels |
| $:/info/browser/screen/height | Screen height in pixels |
| $:/info/node | Running under Node.js? ("yes" or "no") |
| $:/info/url/full | New in: 5.1.14 Full URL of wiki (eg, ) |
| $:/info/url/host | New in: 5.1.14 Host portion of URL of wiki (eg, ) |
| $:/info/url/hostname | New in: 5.1.14 Hostname portion of URL of wiki (eg, ) |
| $:/info/url/origin | New in: 5.1.14 Origin portion of URL of wiki (eg, ) |
| $:/info/url/pathname | New in: 5.1.14 Pathname portion of URL of wiki (eg, ) |
| $:/info/url/port | New in: 5.1.14 Port portion of URL of wiki (eg, ) |
| $:/info/url/protocol | New in: 5.1.14 Protocol portion of URL of wiki (eg, ) |
| $:/info/url/search | New in: 5.1.14 Search portion of URL of wiki (eg, ) |
Chaque tiddler a un panneau d'informations additionnelles. Pour l'afficher, cliquez dans la barre d'outils du tiddler, sur l'icone, puis sur info dans la liste déroulante.
Le panneau d'information comporte les onglets suivants :
- Outils - propose des boutons pour diverses actions à effectuer sur un tiddler. Cocher la case en regard de chaque bouton l'ajoutera dans la barre d'outils du tiddler - Ceci affectera tous les tiddlers de votre wiki.
- Références, Étiqueté, Liste et Listé - Listent différents types de tiddlers connexes. Voir Utiliser des liens pour naviguer entre les tiddlers
- Champs - récapitule tous les champs du tiddler, hormis le champ text
- Avancé - indique si le tiddler est shadow. S'il l'est, mentionne aussi quel plugin le génère et s'il a été remplacé par un tiddler ordinaire.
Pour fermer le panneau d'information, cliquez n'importe où ailleurs.
Initialise un dossier wiki (WikiFolder) vide en copiant l'une des éditions présentes dans le répertoire editions.
--init <édition> [<édition> ...]Par exemple :
tiddlywiki ./MonDossierWiki --init emptyNote :
- Le répertoire correspondant au dossier wiki est créé si nécessaire
- L'édition par défaut est empty
- La commande init échoue si le dossier wiki n'est pas vide
- La commande init supprime les éventuelles définitions
includeWikisdu fichiertiddlywiki.infode l'édition spécifiée - Lorsque plusieurs éditions sont spécifiées, chaque édition écrase les fichiers qu'elle a en commun avec les précédentes (par conséquent, le fichier
tiddlywiki.infoproviendra de la dernière édition spécifiée) --editionsrenvoie une liste des éditions disponibles
See also:
The Innerwiki Plugin enables TiddlyWiki to embed a modified copy of itself (an "innerwiki"). The primary motivation is to be able to produce screenshot illustrations that are automatically up-to-date with the appearance of TiddlyWiki as it changes over time, or to produce the same screenshot in different languages.
In the browser, innerwikis are displayed as an embedded iframe. Under Node.js Google's Puppeteer is used to load the innerwikis as off-screen web pages and then snapshot them as a PNG image.
See the demo at https://tiddlywiki.com/plugins/tiddlywiki/innerwiki
| purpose | insert an item T into a list immediately before an item B |
|---|---|
| input | a selection of titles |
| suffix | B = the name of a variable containing the title of the tiddler before which this one should be inserted |
| parameter | T = the title of the tiddler to insert |
| output | the input tiddler list with the new entry inserted |
If the item B isn't present in the input list then the new item is inserted at the end of the list.
Standalone Configuration
Follow these instructions when using TiddlyWiki as a standalone HTML file:
- Create a backup of your current TiddlyWiki HTML file (just in case)
- Open your TiddlyWiki in a browser
- Open the control panel , click on the Plugins tab and then the Get more plugins button
- Click open plugin library to open the official plugin library
- When the library listing is loaded:
- Use the tab to select between plugins, themes and languages
- Use the search box to search the plugin details
- Click the install button to install a plugin
- Save your TiddlyWiki
- Refresh the page so that TiddlyWiki loads the new plugin
- The plugin should now be available for use
Client-Server Configuration
Follow these instructions when using TiddlyWiki under Node.js:
- Identify the plugins you want to install using the Plugins tab of control panel (don't install the plugins from here, though). Plugins are identified by their type (ie language, theme or plugin) and their publisher and title. For example, the plugin
$:/plugins/tiddlywiki/internalsis referred to as tiddlywiki/internals - Quit the server if it is running
- Edit the
tiddlywiki.infofile (it is in JSON format) and locate theplugins,themesorlanguagessection (see below) - Add entries corresponding to the plugins you wish to add. Take care to retain commas to separate items, but do not terminate the last item in a list with a comma
- Restart the server
{
"plugins": [
"tiddlywiki/codemirror"
],
"themes": [
"tiddlywiki/vanilla",
"tiddlywiki/snowwhite"
],
"languages": [
"es-ES",
"fr-FR",
"en-EN"
]
}Microsoft's Internet Information Server (IIS) is the built-in web server for Windows. It can be useful to host TiddlyWiki within IIS in order to take advantage of IIS features like URL rewriting, static file hosting and automatic restarts after a crash.
1. Enable IIS
- In Windows, access the Control Panel and click Add or Remove Programs
- In the Add or Remove Programs window, click Add/Remove Windows Components.
- Select the Internet Information Services (IIS) check box
- Click Next, then click Finish
2. Install the required tools
- Install the IIS module HttpPlatformHandler from https://www.iis.net/downloads/microsoft/httpplatformhandler
- Install Node.js from https://nodejs.org/
- Install Git from https://git-scm.com/
- optional; only required when using the latest TiddlyWiki release pulled directly from GitHub – see below
3. Install TiddlyWiki and setup a new wiki
- Create a convenient directory for the wiki (e.g.
C:\MyStuff) - Within it, create a file called
C:\MyStuff\package.jsonwith the content:{ "name": "MyStuff", "description": "A description of this wiki", "dependencies": { "sax": "1.2.4", "tiddlywiki": "*" } } - Also create a file called
C:\MyStuff\web.configwith the content:<?xml version="1.0" encoding="UTF-8"?> <configuration> <system.webServer> <handlers> <add name="httpplatformhandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified" requireAccess="Script" /> </handlers> <httpPlatform stdoutLogEnabled="true" stdoutLogFile=".\node.log" startupTimeLimit="20" processPath="C:\Program Files\nodejs\node.exe" arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki --listen port=PORT path-prefix=/MyApp"> <environmentVariables> <environmentVariable name="PORT" value="%HTTP_PLATFORM_PORT%" /> <environmentVariable name="NODE_ENV" value="Production" /> </environmentVariables> </httpPlatform> </system.webServer> </configuration> - Create a subdirectory called "wiki" (i.e.
C:\MyStuff\wiki) - Create a file called
C:\MyStuff\wiki\tiddlywiki.infowith the content:{ "description": "My wiki", "plugins": [ "tiddlywiki/tiddlyweb", "tiddlywiki/filesystem" ], "themes": [ "tiddlywiki/vanilla", "tiddlywiki/snowwhite" ] } - Create a subdirectory called "tiddlers" (i.e.
C:\MyStuff\wiki\tiddlers) - Within it, create a file called
C:\MyStuff\wiki\tiddlers\config-tiddlyweb-host.tidwith the content:title: $:/config/tiddlyweb/host text: $protocol$//$host$/MyApp/- (See the documentation for details of the configuration fields for HttpPlatformHandler
- Execute the command
npm installwithin theC:/MyStuffdirectory
4. Setup the application in IIS
- In Windows, run the IIS Manager application (use the start menu to run
inetmgr.exe) - Locate the server in the Connections column on the left, and click the disclosure triangle to show its content
- Open the Sites folder
- Right click on the Default Web Site entry, and select Add application.. from the menu
- Enter the following information in the dialogue box:
- Alias:
MyApp - Physical path:
C:\MyStuff
- Alias:
- Click OK
5. Test the application
Test the app by visiting http://localhost/MyApp/ in a browser.
Notes
- If you require authentication, specify a username and password in the
--listencommand inweb.config. For example:arguments=".\node_modules\tiddlywiki\tiddlywiki.js ./wiki-server --listen username=joe "password=bloggs" port=PORT path-prefix=/MyApp">- Take note of the need to use double quotes around non-alphanumeric passwords, and to HTML encode them into
"
- If you change the settings in the
web.configfile, or modify the app code, then you'll need to restart the server using the IIS manager application
- Installez Node.js depuis http://nodejs.org
- Ouvrez un terminal en ligne de commande et tapez :
npm install -g tiddlywikiSi cela échoue avec un message d'erreur, il se peut que vous ayez besoin de retaper la commande en tant qu'administrateur :
npm install -g tiddlywiki(Windows)sudo npm install -g tiddlywiki(Mac/Linux) - Vérifiez que TiddlyWiki est bien installé en tapant :
tiddlywiki --version - En réponse, vous devriez voir TiddlyWiki renvoyer la version en cours (par exemple
5.1.2; d'autres informations de débogage peuvent aussi apparaître). - Faites l'essai :
tiddlywiki monnouveauwiki --init serverpour créer un dossier pour un nouveau wiki qui inclura des composants orientés serveurtiddlywiki monnouveauwiki --serverpour démarrer TiddlyWiki- Positionnez votre navigateur sur l'adresse http://127.0.0.1:8080/
- Essayez d'éditer et de créer de nouveaux tiddlers
L'option -g demande à Node.js d'installer TiddlyWiki globalement. Sans elle, TiddlyWiki ne sera disponible uniquement dans le répertoire où vous l'avez installé.
- Clone a local copy of the TiddlyWiki5 GitHub repository from https://github.com/Jermolene/TiddlyWiki5
- Open a command line terminal and change the current working directory to the root of the TiddlyWiki5 repo
- Type
npm link(Windows) orsudo npm link(Mac/Linux) to tell npm to use this copy of the repo as the globally installed one - Inside the root, you can launch TiddlyWiki like this:
tiddlywiki editions/tw5.com-server --listen
After this procedure you can work with TiddlyWiki5 via npm as though it had been installed in the usual way with npm install -g tiddlywiki.
Update the clone from time to time in order to ensure that you have the latest code.
Les Tiddlers d'apprentissage s'adressent directement aux lecteurs et les guident à travers un processus. Le lecteur est aussi bien un débutant qu'un utilisateur moyen.
Ces tiddlers peuvent se subdiviser en :
- Bienvenue
- Qu'est-ce que TiddlyWiki et pourquoi m'en soucier?
- Démonstration des points clés et avantages
- Questions fréquemment posées
- Exemples de TiddlyWiki en action
- Information sur le projet lui-même
- Tutoriel
- Une présentation ordonnée de matériaux pour débutants
- Chaque tiddler introduit une nouveauté ou un concept
- Son contenu principal contient très peu de liens
- Une section "En savoir plus" accessible à la fin peut proposer des liens connexes
- Exercice
- Accompagne un tiddler tutoriel
- Solution obtenue sur demande
- Comment ?
- Une liste d'étapes numérotées pour effectuer une petite tâche spécifique
- Concis, avec des liens vers les tiddlers référents si besoin
- Toujours avec un préambule pour clarifier la nature de la tache
- Exemple
- Accompagne un tiddler référence
- Peut contenir explications et commentaires similaires
- Reste indépendant pour préserver la sobriété du tiddler référence
Les tiddlers d'apprentissage s'adressent directement au lecteur par l'emploie du "vous". Ils peuvent être raisonnablement cordiaux.
Mais ils évitent l'excès de langage académique, culturel, les références à l'actualité et les tentatives de l'humour,car ils peuvent dérouter ou même offenser le lectorat international. Ils évitent aussi de frustrer potentiellement le lecteur par des descriptions caractérisées de commodes ou faciles.
A git choose-your-own-adventure!ⓡ for walking yourself though fixing a broken Git repository.
http://sukima.github.io/GitFixUm/
This document is an attempt to be a fairly comprehensive guide to recovering from what you did not mean to do when using git. It isn't that git is so complicated that you need a large document to take care or your particular problem, it is more that the set of things that you might have done is so large that different techniques are needed depending on exactly what you have done and what you want to have happen.
- Ceci décrit les bases de l'écriture d'un filtre de sélection d'un ensemble de tiddlers. Pour une présentation plus technique, voir Syntaxe d'un filtre.
Le plus simple des cas se présente lorsque vous savez exactement quels tiddlers vous recherchez. Saisissez chaque titre entre une paire de double crochets, un espace entre chacun :
[[Livre de recettes]] [[OeufsBrouillés]] [[Gateau aux pommes de moman]]
Vous pouvez omettre les crochets quand un titre ne contient aucun espace :
[[Livre de recettes]] OeufsBrouillés [[Gateau aux pommes de moman]]
La paire de double crochets est une abréviation de :
[title[OeufsBrouillés]]
... qui offre une syntaxe du modèle général de tous les filtres :
[operateur[paramètre]]
En l'occurence, voici comment sélectionner tous les tiddlers étiquetés Recipe :
[tag[Recette]]
Vous pouvez inverser la sélection en ajoutant le point d'exclamation ! juste avant l'opérateur. Par exemple, nous pouvons sélectionner tous les tiddlers sans l'étiquette Recette :
[!tag[Recette]]
Les tiddlers peuvent être filtrés par d'autres champs que les titres ou les étiquettes :
[field:convive[4]]
Cette exemple sélectionnera tous les tiddlers qui ont 4 dans leur champ convive.
Comme le mot "convive" n'est pas un opérateur filtre standard (et n'est pas près de le devenir), vous pouvez omettre le préfixe field: en toute sécurité :
[convive[4]]
Combinaisons
Les filtres que nous avons examinés jusqu'à présent ont chacun une étape. Mais vous pouvez exécuter plusieurs étapes ensemble comme ceci :
[tag[Végétarien]!tag[soupe]convive[4]]
Notez que la séquence entière est contenue dans une seule paire de crochets.
Un tiddler doit correspondre à toutes les étapes de la séquence. Ainsi l'exemple supra renvoie à toutes les recettes végétariennes (autre que soupes) pour 4 convives.
Une série de séquences séparée sélectionnera les tiddlers qui correspondent à l'une des séquences. Nous pouvons réutiliser ceci pour trouver les recettes pour 3, 4 or 5 convives :
[convive[3]] [convive[4]] [convive[5]]
Si nous voulons ignorer les recettes végétariennes pour 4 convives, nous formulerons ainsi :
[convive[3]] [convive[4]!tag[Végétarien]] [convive[5]]
Par défaut, chaque séquence prend en compte tous les tiddlers du wiki. Mais on peut utiliser le signe + pour ne tenir compte que des seuls tiddlers sélectionnés par les précédentes séquences :
[convive[3]] [convive[4]] [convive[5]] +[tag[Végétarien]] +[sort[titre]]
Ceci sélectionne les recettes pour 3, 4 ou 5 convives, puis filtre celles qui correspondent uniquement aux végétariennes, et enfin trie ce qui reste dans l'ordre alphabétique des titres.
D'une façon similaire, nous pouvons utiliser le signe - pour extraire une séquence de tiddlers du résultat précédent. Ici nous sélectionnons toutes les recettes végétariennes exceptées deux :
[tag[Végétarien]] -[title[OeufsBrouillés]] -HaricotsSurToast
Paramètres spéciaux
Le paramètre de chaque étape que nous avons vu jusqu'à présent s'insérait entre crochets, signifiant un traitement littéral par TiddlyWiki. Mais deux autres formes de parenthèses sont possibles :
Les accolades {} indiquent que le paramètre est une Référence textuelle, et que sa valeur doit être recherchée dans un tiddler spécial. Par exemple, si nous avons un tiddler nommé Préférence dont le texte apparait être le mot Végétarien, nous pouvons dire
[tag{Préférence}]
est une alternative à [tag[Végétarien]]. Ce qui permet à 'préférence' d'évoluer dans le temps.
Les chevrons <> indiquent que le paramètre est le nom d'une variable dont la valeur sera utilisée en lieu et place. Ici, nous utilisons la variable intégrée currentTiddler au sein d'un filtre qui sélectionne tous les tiddlers dont le texte contient le titre du tiddler en cours :
[search<currentTiddler>]
- Ceci décrit les bases de l'écriture d'un filtre de sélection d'un ensemble de tiddlers. Pour une présentation plus technique, voir Syntaxe d'un filtre.
Le plus simple des cas se présente lorsque vous savez exactement quels tiddlers vous recherchez. Saisissez chaque titre entre une paire de double crochets, un espace entre chacun :
[[Livre de recettes]] [[OeufsBrouillés]] [[Gateau aux pommes de moman]]
Vous pouvez omettre les crochets quand un titre ne contient aucun espace :
[[Livre de recettes]] OeufsBrouillés [[Gateau aux pommes de moman]]
La paire de double crochets est une abréviation de :
[title[OeufsBrouillés]]
... qui offre une syntaxe du modèle général de tous les filtres :
[operateur[paramètre]]
En l'occurence, voici comment sélectionner tous les tiddlers étiquetés Recipe :
[tag[Recette]]
Vous pouvez inverser la sélection en ajoutant le point d'exclamation ! juste avant l'opérateur. Par exemple, nous pouvons sélectionner tous les tiddlers sans l'étiquette Recette :
[!tag[Recette]]
Les tiddlers peuvent être filtrés par d'autres champs que les titres ou les étiquettes :
[field:convive[4]]
Cette exemple sélectionnera tous les tiddlers qui ont 4 dans leur champ convive.
Comme le mot "convive" n'est pas un opérateur filtre standard (et n'est pas près de le devenir), vous pouvez omettre le préfixe field: en toute sécurité :
[convive[4]]
Combinaisons
Les filtres que nous avons examinés jusqu'à présent ont chacun une étape. Mais vous pouvez exécuter plusieurs étapes ensemble comme ceci :
[tag[Végétarien]!tag[soupe]convive[4]]
Notez que la séquence entière est contenue dans une seule paire de crochets.
Un tiddler doit correspondre à toutes les étapes de la séquence. Ainsi l'exemple supra renvoie à toutes les recettes végétariennes (autre que soupes) pour 4 convives.
Une série de séquences séparée sélectionnera les tiddlers qui correspondent à l'une des séquences. Nous pouvons réutiliser ceci pour trouver les recettes pour 3, 4 or 5 convives :
[convive[3]] [convive[4]] [convive[5]]
Si nous voulons ignorer les recettes végétariennes pour 4 convives, nous formulerons ainsi :
[convive[3]] [convive[4]!tag[Végétarien]] [convive[5]]
Par défaut, chaque séquence prend en compte tous les tiddlers du wiki. Mais on peut utiliser le signe + pour ne tenir compte que des seuls tiddlers sélectionnés par les précédentes séquences :
[convive[3]] [convive[4]] [convive[5]] +[tag[Végétarien]] +[sort[titre]]
Ceci sélectionne les recettes pour 3, 4 ou 5 convives, puis filtre celles qui correspondent uniquement aux végétariennes, et enfin trie ce qui reste dans l'ordre alphabétique des titres.
D'une façon similaire, nous pouvons utiliser le signe - pour extraire une séquence de tiddlers du résultat précédent. Ici nous sélectionnons toutes les recettes végétariennes exceptées deux :
[tag[Végétarien]] -[title[OeufsBrouillés]] -HaricotsSurToast
Paramètres spéciaux
Le paramètre de chaque étape que nous avons vu jusqu'à présent s'insérait entre crochets, signifiant un traitement littéral par TiddlyWiki. Mais deux autres formes de parenthèses sont possibles :
Les accolades {} indiquent que le paramètre est une Référence textuelle, et que sa valeur doit être recherchée dans un tiddler spécial. Par exemple, si nous avons un tiddler nommé Préférence dont le texte apparait être le mot Végétarien, nous pouvons dire
[tag{Préférence}]
est une alternative à [tag[Végétarien]]. Ce qui permet à 'préférence' d'évoluer dans le temps.
Les chevrons <> indiquent que le paramètre est le nom d'une variable dont la valeur sera utilisée en lieu et place. Ici, nous utilisons la variable intégrée currentTiddler au sein d'un filtre qui sélectionne tous les tiddlers dont le texte contient le titre du tiddler en cours :
[search<currentTiddler>]
Making lists of items plays a central role in working with TiddlyWiki. The following is a brief run-through of some of the more common techniques.
TiddlyWiki uses lists internally for many purposes so the word can have several meanings. Here we are concerned with displaying sequences of items, but not necessarily presented as a conventional bullet list.
Manually Typed Lists
WikiText
WikiText lists are manually typed lists that use a special character to specify what sort of list it is and how it should be displayed.
Examples include bullet lists created with asterisks (*) and numbered lists (#). Behind the scenes, WikiText lists are based on the standard <ul> and <li> HTML elements. For more information see Lists in WikiText.
An example of a typed list in WikiText:
* Greatest Movies of All Time
** Casa Blanca
** Pride and Prejudice and ZombiesAffichera ceci :
- Greatest Movies of All Time
- Casa Blanca
- Pride and Prejudice and Zombies
Generated Lists
Lists can be automatically generated with the ListWidget using filters in which filter operators specify criteria for selecting which tiddlers are desired as output. Shortcut macros are provided for some common types of list.
ListWidget
The ListWidget is the most powerful tool for creating lists. It allows the filtered output to be manipulated and styled into forms that may not seem to resemble lists at all, for example tables or complex texts. For more details, see ListWidget.
An example to show all tiddlers tagged with "HelloThere" might look like:
<$list filter="[tag[HelloThere]]"><$view field="title"/><br/></$list>Affichera ceci :
Discover TiddlyWiki
Some of the things you can do with TiddlyWiki
Ten reasons to switch to TiddlyWiki
Examples
History of TiddlyWiki
What happened to the original TiddlyWiki?
A Gentle Guide to TiddlyWiki
Filtered transclusion
The syntax for filtered transclusion {{{...}}} takes a filter as input and outputs a linked list of matching titles. You can also apply a template, for example:
{{{ [tag[HelloThere]] || $:/core/ui/TagTemplate }}}Affichera ceci :
list-links Macro
The list-links macro gives a preformatted list, typically a bullet list, in a more simplified way than by using the ListWidget. Behind the scenes it really is the ListWidget applying a default template to each list item.
<<list-links "[tag[HelloThere]]">>Affichera ceci :
Other “list related” features
list, list-before and list-after are all field names to control the position of tiddlers in a list. Fields are a way to add additional bits of structured information to a tiddler such as date, quantity, category, etc.
list and listed are filter operators to, respectively, select and find titles in lists.
Cette rapide présentation explique les principes de base de TiddlyWiki.
On peut trouver le TiddlyWiki utilisé pour produire cette vidéo ici :
| purpose | filter the input by fundamental category |
|---|---|
| input | a selection of titles |
| parameter | C = a category |
| output | those input tiddlers that belong to category C |
! output | those input tiddlers that do not belong to category C |
The parameter C is one of the following fundamental categories:
| Category | Matches any tiddler that... |
|---|---|
current | is the current tiddler |
image | has an image ContentType |
missing | does not exist (other than possibly as a shadow tiddler), regardless of whether there are any links to it |
orphan | has no hard links to it |
shadow | is a shadow tiddler, regardless of whether it has been overridden with a non-shadow tiddler |
system | is a system tiddler, i.e. its title starts with $:/ |
tag | is in use as a tag |
tiddler | exists as a non-shadow tiddler |
If C is anything else an error message is returned. New in: 5.1.14 if C is blank, the output is passed through unchanged (in earlier versions an error message was returned).
!is[tiddler] is a synonym for is[missing], and vice versa.
When is[missing] is the first operator in a run, its output is always empty. And when is[shadow] comes first, it outputs only those shadow tiddlers that have been overridden. This is because the initial input to a run contains only non-shadow tiddlers.
The all operator is similar, but its scope is the whole wiki.
[is[tag]]
[!is[tag]]
[all[shadows]!is[system]]
$:/[is[system]tag[$:/tags/Stylesheet]]
[all[shadows]is[system]tag[$:/tags/Stylesheet]]
[is[shadow]]
[is[missing]]
JavaScript est un langage de programmation introduit initialement sur les navigateurs comme une façon de scripter des pages web. Il était considéré au début comme un jouet pas très bien conçu, mais avec les années, il finit par être reconnu comme un langage puissant en tant que tel, et est très largement adopté dans les navigateurs et au-delà.
JavaScript ressemble à ça :
function surfaceDuCercle(rayon) {
return rayon * 2 * 3.141592653;
}JSON est un format de texte brut employé pour modéliser objets de structures hiérarchique contenant des champs nommés (fields).
Les Tiddlers Data peuvent avoir un contenu JSON.
La macro jsontiddlers renvoie le contenu d'un tiddler au format JSON.
Je suis l'inventeur original de TiddlyWiki. Vous pouvez me retrouver sur ces services :
- jeremy (at) jermolene (dot) com
- Jermolene on GitHub
- Jermolene on GitTip, micropaiements
- @Jermolene on Twitter
- Jermy on LinkedIn
- Jermy on Flickr
Encore plus d'infos :
- Une interview de moi sur The Inquirer par Wendy Grossman
- Une interview hilarante avec moi de la télévision britanique en 1983
- Ici, un vidéo de présentation que j'ai réalisée en 2007 appelée "How to Start an Open Source Project".
| purpose | apply JSON string encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with JSON string encodings applied |
The following substitutions are made:
| Character | Replacement |
|---|---|
\ | \\ |
" | \\ |
' | \\ |
\r (carriage return) | \\r |
\n (line feed) | \\n |
| Characters from 0x00 to 0x1f | \\x## where ## is two hex digits |
| Characters from 0x80 to 0xffff | \\u#### where #### is four hex digits |
Also see the stringify Operator.
[[Title with "double quotes" and single ' and \backslash]] +[jsonstringify[]]
Un tiddler JSON tiddler est un tiddler data contenant une structure JSON dans son champ text.
Son ContentType est application/json.
history list est un bon exemple de tiddler JSON.
The jsontiddlers macro returns the fields of a selection of tiddlers in JSON form.
An example can be seen in the template tiddler for JSON exports.
Parameters
- filter
- A filter selecting which tiddlers to include
Ce plugin ajoute la possibilité d'afficher les notations mathématiques écrites en in LaTeX.
Keyboard Shortcut Descriptors are used by the KeyboardWidget and within Tiddlers tagged to link actions with a keyboard combination
A Keyboard Shortcut Descriptor has the following format:
ctrl+enter
ctrl+shift+alt+A
alt-shift-T
alt-SpaceIt can have multiple Key combinations:
ctrl+enter alt+shift+A ctrl+alt+9 alt-Space ctrl-BackspaceThere are two ways Keyboard Shortcut Descriptors can be used:
- directly
- passing the attribute
key="ctrl-enter"to the KeyboardWidget - setting
ctrl-enteras the value of thekeyfield in a Tiddler tagged
- passing the attribute
- with a reference to a configuration Tiddler
- A configuration Tiddler for Keyboard Shortcuts follows some naming rules:
- The title starts with
$:/config/ - Followed by either the string
shortcutsor one of the following platform descriptors:shortcuts-linuxshortcuts-not-linuxshortcuts-macshortcuts-not-macshortcuts-windowsshortcuts-not-windows
- The title ends with another
/followed by a suffix that can be chosen freely- This suffix is the identifier for the
Keyboard Shortcut Descriptor(A)
- This suffix is the identifier for the
- The title starts with
- The reference to the configuration Tiddler is made of
((+ the identifier (A) +))- Example:
((my-shortcut))is the reference to these configuration Tiddlers:
- Example:
- Finally, the referenced configuration Tiddler stores the Keyboard Shortcut Descriptor in its text field
- A configuration Tiddler for Keyboard Shortcuts follows some naming rules:
A Keyboard Shortcut Tiddler is made of three parts:
- The Tag
- The field
keywith a Keyboard Shortcut Descriptor as its value - Actions in its text field
If the Keyboard Shortcut Descriptor has the form ((my-shortcut)) it's a reference to a configuration Tiddler that stores the corresponding Keyboard Shortcut
In order to make a shortcut editable through the Raccourcis clavier Tab in the $:/ControlPanel it's sufficient to create a tiddler $:/config/ShortcutInfo/my-shortcut, where the suffix is the reference used for the Keyboard Shortcut
La prise en compte des raccourcis clavier est actuellement très limitée mais s'accroîtra dans les versions futures.
Raccourcis de saisie
| Touches | Description du raccourci |
| ctrl-enter | Valide les modifications effectuées dans le tiddler en cours de saisie |
| escape | Annule les modification effectuées dans le tiddler en cours de saisie |
Introduction
The keyboard widget allows ActionWidgets to be triggered by specific key combinations. There is also a shorthand for generating Messages via the message and param attributes.
Content and Attributes
The content of the <$keyboard> widget is rendered normally. The keyboard shortcuts only take effect when the focus is within the contained content.
| Attribute | Description |
|---|---|
| actions | A string containing ActionWidgets to be triggered when the key combination is detected |
| message | The title of the WidgetMessage to generate |
| param | The parameter to be passed with the WidgetMessage |
| key | Key string identifying the key(s) to be trapped (see below) |
| class | A CSS class to be assigned to the generated HTML DIV element |
| tag | New in: 5.1.14 The html element the widget creates to capture the keyboard event, defaults to: » span when parsed in inline-mode» div when parsed in block-mode |
Key Strings
Key strings are made up of one or more key specifiers separated by spaces. Each key specifier is zero or more of the modifiers alt, shift, ctrl or meta followed by the name of a key, all joined with "+" plus or "-" minus symbols. Key names are either the letter or digit printed on the key (eg "a" or "1"), or one of the special keys backspace, tab, enter or escape.
For example:
A
shift+A
shift+escape
ctrl+enter
ctrl+shift+alt+A티들리위키 한국어 번역은 다음에서 사용할 수 있습니다:
Here is an example of using the ListWidget and the TranscludeWidget to show a grid of all of Language Icons which are tiddlers tagged and
%22%2F%3E%0A%3Cg%20id%3D%22plus_ultra%22%20fill%3D%22%23c8b100%22%20stroke%3D%22none%22%3E%0A%3Cpath%20d%3D%22m166.42%20264.65c1.99-0.72%203.29-1.58%202.66-3.14-0.41-1-1.43-1.19-2.97-0.63l-2.71%200.99%202.44%206.03c0.27-0.12%200.54-0.24%200.81-0.34%200.28-0.1%200.57-0.18%200.85-0.26l-1.08-2.64v-0.01zm-1.18-2.91l0.69-0.25c0.57-0.21%201.21%200.1%201.5%200.8%200.21%200.53%200.16%201.13-0.5%201.55-0.21%200.13-0.46%200.23-0.7%200.33l-0.99-2.43%22%2F%3E%0A%3Cpath%20d%3D%22m172.78%20259.22c-0.29%200.08-0.57%200.16-0.86%200.22-0.29%200.05-0.59%200.09-0.88%200.12l1.41%206.28%204.38-0.88c-0.05-0.12-0.12-0.26-0.14-0.38-0.03-0.14-0.03-0.28-0.04-0.41-0.77%200.22-1.61%200.46-2.61%200.66l-1.26-5.61%22%2F%3E%0A%3Cpath%20d%3D%22m181.56%20264.63c0.82-2.28%201.82-4.46%202.81-6.67-0.18%200.03-0.36%200.06-0.54%200.07s-0.37%200.01-0.54%200c-0.53%201.61-1.18%203.21-1.87%204.8-0.82-1.51-1.73-2.99-2.43-4.51-0.34%200.04-0.69%200.09-1.03%200.12-0.34%200.02-0.7%200.01-1.04%200.02%201.26%202.06%202.48%204.11%203.64%206.23%200.16-0.03%200.32-0.06%200.5-0.08%200.16-0.01%200.33%200.01%200.5%200.02%22%2F%3E%0A%3Cpath%20d%3D%22m190.72%20259.8c0.15-0.31%200.31-0.6%200.48-0.89-0.24-0.22-0.96-0.55-1.81-0.63-1.79-0.18-2.81%200.61-2.93%201.69-0.26%202.26%203.31%202.07%203.14%203.57-0.07%200.64-0.75%200.9-1.48%200.83-0.81-0.08-1.41-0.53-1.51-1.19l-0.22-0.02c-0.12%200.39-0.29%200.77-0.48%201.15%200.53%200.34%201.21%200.53%201.85%200.59%201.83%200.19%203.22-0.54%203.35-1.74%200.23-2.15-3.37-2.27-3.23-3.54%200.06-0.53%200.47-0.88%201.4-0.79%200.67%200.07%201.08%200.43%201.26%200.95l0.18%200.02%22%2F%3E%0A%3Cpath%20d%3D%22m310.3%20264.98c0.62-2.33%201.41-4.58%202.19-6.87-0.17%200.05-0.35%200.09-0.53%200.11-0.17%200.03-0.36%200.04-0.54%200.05-0.37%201.64-0.88%203.29-1.42%204.94-0.96-1.44-2-2.84-2.83-4.3-0.34%200.07-0.68%200.15-1.02%200.2s-0.69%200.07-1.04%200.11c1.45%201.94%202.85%203.89%204.2%205.91%200.16-0.04%200.32-0.1%200.5-0.12%200.16-0.02%200.33-0.02%200.49-0.03%22%2F%3E%0A%3Cpath%20d%3D%22m316.48%20258.16c-0.29%200.01-0.59%200.04-0.88%200.03-0.3%200-0.6-0.04-0.89-0.06l-0.12%206.41%204.49%200.08c-0.03-0.13-0.06-0.28-0.06-0.41s0.04-0.27%200.07-0.4c-0.81%200.05-1.68%200.1-2.71%200.08l0.1-5.73%22%2F%3E%0A%3Cpath%20d%3D%22m323.52%20259.21c0.72%200.06%201.41%200.19%202.1%200.31-0.01-0.13-0.03-0.27-0.02-0.41%200.01-0.13%200.06-0.26%200.1-0.39l-6.07-0.5c0.01%200.14%200.03%200.27%200.02%200.4-0.01%200.14-0.06%200.27-0.1%200.4%200.62-0.02%201.37-0.02%202.21%200.05l-0.53%205.77c0.29%200%200.59%200%200.88%200.03%200.3%200.02%200.59%200.07%200.88%200.11l0.53-5.77%22%2F%3E%0A%3Cpath%20d%3D%22m326.01%20265.53c0.29%200.05%200.59%200.09%200.88%200.15%200.28%200.06%200.57%200.15%200.85%200.23l0.72-2.94%200.08%200.01c0.16%200.41%200.38%200.9%200.49%201.19l0.9%202.22c0.36%200.06%200.71%200.11%201.05%200.18%200.36%200.08%200.7%200.18%201.04%200.28l-0.31-0.67c-0.48-1-0.99-2.01-1.41-3.02%201.12%200.04%201.98-0.36%202.2-1.26%200.15-0.62-0.1-1.11-0.68-1.53-0.44-0.31-1.28-0.47-1.83-0.6l-2.44-0.53-1.54%206.29m3.14-5.42c0.71%200.16%201.59%200.27%201.59%201.07-0.01%200.21-0.03%200.35-0.06%200.48-0.23%200.94-0.94%201.26-2.13%200.91l0.6-2.46%22%2F%3E%0A%3Cpath%20d%3D%22m337.57%20267.46c-0.05%200.69-0.18%201.37-0.31%202.1%200.3%200.14%200.61%200.27%200.9%200.44%200.3%200.16%200.57%200.34%200.86%200.52l0.6-7.23c-0.14-0.06-0.27-0.12-0.41-0.19-0.13-0.07-0.25-0.15-0.37-0.24l-6.38%204.05c0.17%200.08%200.35%200.16%200.51%200.25%200.17%200.09%200.31%200.19%200.47%200.28%200.54-0.45%201.1-0.82%201.74-1.3l2.39%201.31v0.01zm-1.81-1.66l2.13-1.37-0.25%202.4-1.88-1.03%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22crown_crest%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20stroke-width%3D%220.26%22%20d%3D%22m249.65%20182.72c6.64%200%2012.56%200.99%2016.41%202.51%202.2%201%205.16%201.73%208.4%202.17%202.47%200.33%204.81%200.39%206.85%200.24%202.73-0.06%206.67%200.74%2010.62%202.48%203.26%201.45%205.99%203.21%207.8%204.91l-1.57%201.4-0.45%203.96-4.3%204.92-2.15%201.83-5.09%204.07-2.6%200.21-0.79%202.25-32.91-3.86-33.02%203.86-0.79-2.25-2.61-0.21-5.08-4.07-2.15-1.83-4.3-4.92-0.44-3.96-1.58-1.4c1.82-1.7%204.54-3.46%207.8-4.91%203.95-1.74%207.89-2.54%2010.62-2.48%202.04%200.15%204.38%200.09%206.85-0.24%203.24-0.44%206.2-1.17%208.4-2.17%203.86-1.52%209.44-2.51%2016.08-2.51z%22%2F%3E%0A%3Cg%20fill%3D%22%23c8b100%22%3E%0A%3Cpath%20d%3D%22m225.34%20191.42l1.38%201.11%202.08-3.4c-2.25-1.38-3.8-3.78-3.8-6.51%200-0.31%200.02-0.61%200.06-0.91%200.21-4.34%205.5-7.92%2012.2-7.92%203.48%200%206.63%200.95%208.84%202.48%200.06-0.67%200.12-1.25%200.21-1.86-2.43-1.42-5.6-2.28-9.05-2.28-7.71%200-13.74%204.39-14.03%209.57-0.03%200.31-0.05%200.61-0.05%200.92%200%202.76%201.26%205.26%203.26%206.99l-1.1%201.81%22%2F%3E%0A%3Cpath%20d%3D%22m225.43%20191.46c-2.63-1.97-4.27-4.64-4.27-7.58%200-3.38%202.22-6.4%205.58-8.41-2.07%201.67-3.33%203.83-3.51%206.23-0.03%200.31-0.05%200.61-0.05%200.92%200%202.76%201.26%205.26%203.26%206.99l-1.01%201.85%22%2F%3E%0A%3Cpath%20d%3D%22m202.21%20194.89c-1.48-1.65-2.38-3.79-2.38-6.12%200-1.41%200.33-2.75%200.91-3.95%202.13-4.38%208.82-7.57%2016.76-7.57%202.16%200%204.23%200.23%206.14%200.67-0.42%200.46-0.75%200.97-1.08%201.48-1.59-0.31-3.29-0.48-5.06-0.48-7.27%200-13.36%202.83-15.12%206.65-0.47%200.97-0.73%202.06-0.73%203.2%200%202.32%201.09%204.4%202.79%205.82l-2.63%204.3-1.41-1.12%201.81-2.88z%22%2F%3E%0A%3Cpath%20d%3D%22m204.9%20180.48c-1.91%201.21-3.36%202.69-4.16%204.34-0.58%201.2-0.91%202.54-0.91%203.95%200%202.33%200.9%204.47%202.38%206.12l-1.6%202.59c-1.53-1.96-2.42-4.26-2.42-6.7%200-4.2%202.67-7.87%206.71-10.3z%22%2F%3E%0A%3Cpath%20d%3D%22m250.04%20171.27c1.76%200%203.28%201.16%203.64%202.73%200.23%201.38%200.38%202.95%200.41%204.62%200.01%200.18-0.01%200.35-0.01%200.52%200%200.2%200.04%200.41%200.05%200.61%200.06%203.52%200.56%206.62%201.27%208.52l-5.36%205.14-5.43-5.14c0.72-1.9%201.22-5%201.29-8.52%200-0.2%200.04-0.41%200.04-0.61%200-0.17-0.01-0.34-0.01-0.52%200.03-1.67%200.18-3.24%200.41-4.62%200.36-1.57%201.94-2.73%203.7-2.73z%22%2F%3E%0A%3Cpath%20d%3D%22m250.04%20172.94c0.91%200%201.68%200.58%201.87%201.39%200.23%201.31%200.37%202.8%200.4%204.38%200%200.16-0.01%200.32-0.01%200.48%200%200.2%200.03%200.39%200.04%200.59%200.05%203.32%200.53%206.25%201.21%208.05l-3.54%203.35-3.54-3.35c0.67-1.8%201.15-4.73%201.21-8.05%200-0.2%200.04-0.39%200.04-0.59%200-0.16-0.01-0.32-0.01-0.48%200.03-1.58%200.17-3.07%200.4-4.38%200.18-0.81%201.02-1.39%201.93-1.39z%22%2F%3E%0A%3Cpath%20d%3D%22m274.7%20191.42l-1.39%201.11-2.08-3.4c2.26-1.38%203.81-3.78%203.81-6.51%200-0.31-0.02-0.61-0.06-0.91-0.21-4.34-5.5-7.92-12.2-7.92-3.49%200-6.63%200.95-8.84%202.48-0.06-0.67-0.12-1.25-0.22-1.86%202.44-1.42%205.6-2.28%209.06-2.28%207.71%200%2013.74%204.39%2014.03%209.57%200.03%200.31%200.05%200.61%200.05%200.92%200%202.76-1.27%205.26-3.27%206.99l1.11%201.81%22%2F%3E%0A%3Cpath%20d%3D%22m274.61%20191.46c2.63-1.97%204.27-4.64%204.27-7.58%200-3.38-2.22-6.4-5.58-8.41%202.07%201.67%203.33%203.83%203.51%206.23%200.03%200.31%200.05%200.61%200.05%200.92%200%202.76-1.27%205.26-3.27%206.99l1.02%201.85%22%2F%3E%0A%3Cpath%20d%3D%22m297.83%20194.89c1.47-1.65%202.38-3.79%202.38-6.12%200-1.41-0.33-2.75-0.91-3.95-2.14-4.38-8.82-7.57-16.76-7.57-2.16%200-4.23%200.23-6.15%200.67%200.43%200.46%200.76%200.97%201.09%201.48%201.58-0.31%203.29-0.48%205.06-0.48%207.27%200%2013.35%202.83%2015.11%206.65%200.47%200.97%200.73%202.06%200.73%203.2%200%202.32-1.09%204.4-2.79%205.82l2.63%204.3%201.42-1.12-1.81-2.88z%22%2F%3E%0A%3Cpath%20d%3D%22m295.14%20180.48c1.91%201.21%203.36%202.69%204.16%204.34%200.58%201.2%200.91%202.54%200.91%203.95%200%202.33-0.91%204.47-2.38%206.12l1.6%202.59c1.53-1.96%202.41-4.26%202.41-6.7%200-4.2-2.67-7.87-6.7-10.3z%22%2F%3E%0A%3Cellipse%20fill%3D%22%23005bbf%22%20stroke-width%3D%220.26%22%20cx%3D%22250.05%22%20cy%3D%22167.3%22%20rx%3D%224.43%22%20ry%3D%224.2%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.26%22%20d%3D%22m248.89%20155.54v2.26h-2.42v2.3h2.42v3.15%203.46h-3.05c-0.03%200.21-0.22%200.37-0.22%200.59%200%200.58%200.12%201.14%200.35%201.64%200%200.02%200.02%200.02%200.03%200.03h8.12c0-0.01%200.02-0.01%200.03-0.03%200.22-0.5%200.35-1.06%200.35-1.64%200-0.22-0.19-0.38-0.22-0.59h-2.96v-3.43-3.18h2.42v-2.3h-2.42v-2.26h-2.43z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22%23fff%22%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22188.94%22%20rx%3D%221.91%22%20ry%3D%221.8%22%2F%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22185.4%22%20rx%3D%221.91%22%20ry%3D%221.8%22%2F%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22181.6%22%20rx%3D%221.52%22%20ry%3D%221.44%22%2F%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22178.18%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22250.04%22%20cy%3D%22175.18%22%20rx%3D%220.88%22%20ry%3D%220.83%22%2F%3E%0A%3Cellipse%20cx%3D%22198.94%22%20cy%3D%22198.67%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22197.44%22%20cy%3D%22196.02%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22196.44%22%20cy%3D%22192.94%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22196.31%22%20cy%3D%22189.64%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22197.12%22%20cy%3D%22186.4%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22198.81%22%20cy%3D%22183.45%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22201.06%22%20cy%3D%22181.02%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22203.68%22%20cy%3D%22179.01%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22206.8%22%20cy%3D%22177.36%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22210.04%22%20cy%3D%22176.19%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22213.66%22%20cy%3D%22175.54%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22217.1%22%20cy%3D%22175.36%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22220.47%22%20cy%3D%22175.48%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22224.21%22%20cy%3D%22190.32%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22222.34%22%20cy%3D%22187.65%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22221.35%22%20cy%3D%22184.75%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22221.47%22%20cy%3D%22181.57%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22222.16%22%20cy%3D%22178.37%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22223.84%22%20cy%3D%22175.48%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22226.4%22%20cy%3D%22173.47%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22229.39%22%20cy%3D%22171.81%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22232.7%22%20cy%3D%22170.82%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22236.13%22%20cy%3D%22170.23%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22239.5%22%20cy%3D%22170.28%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22242.99%22%20cy%3D%22170.87%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22246.23%22%20cy%3D%22171.99%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22253.8%22%20cy%3D%22171.99%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22257.04%22%20cy%3D%22170.87%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22260.54%22%20cy%3D%22170.28%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22263.9%22%20cy%3D%22170.23%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22267.34%22%20cy%3D%22170.82%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22270.64%22%20cy%3D%22171.81%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22273.64%22%20cy%3D%22173.47%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22276.19%22%20cy%3D%22175.48%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22277.88%22%20cy%3D%22178.37%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22278.57%22%20cy%3D%22181.57%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22278.69%22%20cy%3D%22184.75%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22277.69%22%20cy%3D%22187.65%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22275.83%22%20cy%3D%22190.32%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22279.57%22%20cy%3D%22175.48%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22282.94%22%20cy%3D%22175.36%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22286.38%22%20cy%3D%22175.54%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22290%22%20cy%3D%22176.19%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22293.24%22%20cy%3D%22177.36%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22296.36%22%20cy%3D%22179.01%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22298.97%22%20cy%3D%22181.02%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22301.22%22%20cy%3D%22183.45%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22302.91%22%20cy%3D%22186.4%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22303.72%22%20cy%3D%22189.64%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22303.6%22%20cy%3D%22192.94%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22302.6%22%20cy%3D%22196.02%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3Cellipse%20cx%3D%22301.1%22%20cy%3D%22198.67%22%20rx%3D%221.1%22%20ry%3D%221.04%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22%23c8b100%22%3E%0A%3Cpath%20d%3D%22m250.15%20226.18c-12.26-0.02-23.25-1.47-31.09-3.83-0.57-0.18-0.87-0.7-0.84-1.25-0.01-0.52%200.29-1%200.84-1.17%207.84-2.36%2018.83-3.81%2031.09-3.83%2012.27%200.02%2023.25%201.47%2031.09%203.83%200.55%200.17%200.84%200.65%200.83%201.17%200.03%200.55-0.27%201.07-0.83%201.25-7.84%202.36-18.82%203.81-31.09%203.83%22%2F%3E%0A%3Cpath%20d%3D%22m250.07%20216.09c-12.41%200.03-23.55%201.58-31.39%204%200.65-0.31%200.59-1.12-0.22-3.2-0.98-2.53-2.5-2.42-2.5-2.42%208.66-2.56%2020.73-4.16%2034.16-4.18%2013.44%200.02%2025.6%201.62%2034.27%204.18%200%200-1.53-0.11-2.51%202.42-0.81%202.08-0.87%202.89-0.21%203.2-7.84-2.42-19.19-3.97-31.6-4%22%2F%3E%0A%3Cpath%20d%3D%22m250.12%20210.3c-13.43%200.02-25.5%201.62-34.16%204.18-0.58%200.17-1.19-0.05-1.38-0.6s0.12-1.18%200.7-1.35c8.71-2.67%2021.08-4.35%2034.84-4.38%2013.77%200.03%2026.19%201.71%2034.9%204.38%200.58%200.17%200.89%200.8%200.7%201.35s-0.8%200.77-1.38%200.6c-8.67-2.56-20.78-4.16-34.22-4.18%22%2F%3E%0A%3Cpath%20d%3D%22m250.2%20199.78l1.23%200.22c-0.19%200.5-0.24%201.05-0.24%201.63%200%202.57%202.21%204.65%204.92%204.65%202.18%200%204.04-1.35%204.67-3.21%200.08%200.05%200.47-1.68%200.68-1.66%200.17%200.02%200.15%201.8%200.22%201.77%200.31%202.34%202.46%203.93%204.87%203.93%202.71%200%204.91-2.08%204.91-4.65%200-0.19-0.01-0.38-0.04-0.57l1.54-1.52%200.83%201.94c-0.33%200.61-0.46%201.3-0.46%202.03%200%202.46%202.1%204.44%204.69%204.44%201.63%200%203.06-0.78%203.9-1.97l0.99-1.25-0.01%201.53c0%201.55%200.66%202.93%202.16%203.18%200%200%201.73%200.1%204.03-1.7%202.29-1.8%203.55-3.29%203.55-3.29l0.2%201.8s-1.9%202.95-3.97%204.15c-1.14%200.66-2.86%201.35-4.23%201.13-1.44-0.24-2.48-1.4-3.01-2.74-1.03%200.61-2.25%200.97-3.55%200.97-2.81%200-5.33-1.54-6.32-3.86-1.29%201.4-3.09%202.25-5.2%202.25-2.24%200-4.29-1.01-5.57-2.56-1.27%201.16-2.98%201.87-4.88%201.87-2.48%200-4.69-1.22-5.94-3.05-1.25%201.83-3.46%203.05-5.94%203.05-1.89%200-3.61-0.71-4.87-1.87-1.28%201.55-3.34%202.56-5.58%202.56-2.11%200-3.9-0.85-5.19-2.25-1%202.32-3.52%203.86-6.32%203.86-1.31%200-2.52-0.36-3.55-0.97-0.54%201.34-1.57%202.5-3.02%202.74-1.36%200.22-3.08-0.47-4.22-1.13-2.08-1.2-3.98-4.15-3.98-4.15l0.2-1.8s1.27%201.49%203.56%203.29c2.29%201.81%204.02%201.7%204.02%201.7%201.51-0.25%202.16-1.63%202.16-3.18l-0.01-1.53%200.99%201.25c0.84%201.19%202.28%201.97%203.9%201.97%202.59%200%204.69-1.98%204.69-4.44%200-0.73-0.13-1.42-0.46-2.03l0.83-1.94%201.54%201.52c-0.02%200.19-0.04%200.38-0.04%200.57%200%202.57%202.2%204.65%204.91%204.65%202.42%200%204.56-1.59%204.88-3.93%200.06%200.03%200.05-1.75%200.22-1.77%200.2-0.02%200.6%201.71%200.67%201.66%200.64%201.86%202.49%203.21%204.68%203.21%202.71%200%204.91-2.08%204.91-4.65%200-0.58-0.03-1.13-0.24-1.63l1.29-0.22%22%2F%3E%0A%3Cpath%20d%3D%22m208.37%20206.32c-0.11-0.37-0.35-0.75-0.72-1.06-0.79-0.68-1.84-0.79-2.36-0.25-0.07%200.07-0.13%200.17-0.17%200.25%200%200-1.11-2.08-2.41-2.78-1.29-0.7-3.49-0.52-3.49-0.52%200-1.6%201.3-2.89%202.99-2.89%200.99%200%201.92%200.41%202.48%201.11l0.23-1.07s1.36%200.27%201.98%201.82-0.06%203.8-0.06%203.8%200.34-0.96%200.85-1.61c0.51-0.64%201.81-1.34%202.49-1.66%200.67-0.31%201.37-0.79%201.37-0.79s0.03%200.18%200.05%200.61c0.03%200.51-0.01%200.83-0.01%200.83%201.24-0.17%202.69%200.04%203.83%200.48-0.49%200.95-1.41%201.84-2.62%202.3%200%200%200.44%200.36%200.83%200.75%200.34%200.34%200.44%200.49%200.44%200.49s-0.85%200.13-1.27%200.19c-0.43%200.05-1.84%200.28-2.69%200.22-0.62-0.04-1.32-0.14-1.74-0.22%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m205.29%20205.01c0.52-0.54%201.57-0.43%202.36%200.25%200.8%200.67%201.02%201.66%200.51%202.19-0.51%200.54-1.57%200.42-2.36-0.25-0.79-0.68-1.02-1.66-0.51-2.19%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m216.39%20205.91c-0.28-0.83-0.03-1.65%200.57-1.83%200.6-0.19%201.32%200.33%201.6%201.16s0.03%201.65-0.57%201.84c-0.6%200.18-1.31-0.34-1.6-1.17%22%2F%3E%0A%3Cpath%20d%3D%22m226.12%20201.86c-0.33-0.27-0.59-0.64-0.67-1.08s0.01-0.87%200.23-1.23c0%200-0.88-0.44-1.83-0.69-0.72-0.19-1.99-0.2-2.37-0.2-0.38-0.02-1.15-0.03-1.15-0.03s0.07%200.17%200.28%200.55c0.27%200.46%200.5%200.75%200.5%200.75-1.27%200.29-2.35%201.12-3.03%202.09%200.99%200.68%202.3%201.1%203.6%200.97%200%200-0.12%200.34-0.2%200.86-0.06%200.43-0.06%200.61-0.06%200.61s0.71-0.26%201.07-0.39c0.35-0.13%201.54-0.55%202.15-0.96%200.8-0.54%201.48-1.25%201.48-1.25%22%2F%3E%0A%3Cpath%20d%3D%22m225.68%20191.65c1.06%200.67%201.98%201.79%202.3%203.03%200%200%200.13-0.25%200.71-0.59%200.59-0.33%201.09-0.32%201.09-0.32s-0.17%200.97-0.25%201.32c-0.09%200.34-0.09%201.38-0.32%202.32-0.23%200.93-0.63%201.68-0.63%201.68-0.42-0.34-0.99-0.51-1.58-0.41-0.58%200.1-1.06%200.44-1.32%200.9%200%200-0.66-0.58-1.21-1.38-0.55-0.81-0.93-1.78-1.13-2.08-0.21-0.3-0.72-1.15-0.72-1.15s0.47-0.18%201.14-0.05c0.67%200.12%200.88%200.32%200.88%200.32-0.14-1.28%200.28-2.62%201.04-3.59%22%2F%3E%0A%3Cpath%20d%3D%22m228.97%20201.38c0.22-0.35%200.32-0.79%200.24-1.23s-0.32-0.81-0.66-1.07c0%200%200.67-0.71%201.47-1.26%200.6-0.41%201.8-0.82%202.15-0.95%200.36-0.13%201.07-0.4%201.07-0.4s0%200.18-0.06%200.61c-0.08%200.52-0.2%200.87-0.2%200.87%201.3-0.14%202.62%200.29%203.61%200.98-0.69%200.97-1.77%201.79-3.04%202.08%200%200%200.23%200.28%200.5%200.74%200.21%200.39%200.28%200.56%200.28%200.56s-0.77-0.02-1.15-0.03c-0.38%200-1.65-0.01-2.37-0.2-0.95-0.25-1.84-0.69-1.84-0.69%22%2F%3E%0A%3Cellipse%20fill%3D%22%23ad1519%22%20cx%3D%22227.37%22%20cy%3D%22200.45%22%20rx%3D%222.17%22%20ry%3D%222.06%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m237.76%20201.77c-0.11-0.87%200.31-1.63%200.93-1.7%200.63-0.07%201.23%200.57%201.34%201.44%200.11%200.86-0.3%201.63-0.93%201.7-0.62%200.07-1.22-0.57-1.34-1.44%22%2F%3E%0A%3Cpath%20d%3D%22m248.5%20199.83c-0.32-0.36-0.53-0.82-0.53-1.33%200-0.5%200.19-0.97%200.51-1.32%200%200-0.89-0.67-1.89-1.12-0.77-0.35-2.18-0.59-2.6-0.67-0.43-0.08-1.28-0.24-1.28-0.24s0.04%200.2%200.2%200.67c0.2%200.56%200.4%200.93%200.4%200.93-1.47%200.08-2.85%200.81-3.81%201.76%200.96%200.94%202.34%201.66%203.81%201.75%200%200-0.2%200.36-0.4%200.93-0.16%200.46-0.2%200.67-0.2%200.67s0.85-0.16%201.28-0.24c0.42-0.08%201.83-0.32%202.6-0.67%201-0.46%201.91-1.11%201.91-1.11%22%2F%3E%0A%3Cpath%20d%3D%22m250.11%20188.36c1.05%200.95%201.85%202.36%201.95%203.82%200%200%200.19-0.27%200.91-0.53%200.73-0.26%201.28-0.16%201.28-0.16s-0.39%201.05-0.55%201.42c-0.17%200.37-0.39%201.53-0.84%202.53-0.44%201-1.05%201.76-1.05%201.76-0.4-0.45-1-0.75-1.67-0.75-0.68%200-1.27%200.3-1.67%200.75%200%200-0.61-0.76-1.05-1.76-0.45-1-0.67-2.16-0.84-2.53s-0.56-1.42-0.56-1.42%200.56-0.1%201.28%200.16%200.92%200.53%200.92%200.53c0.1-1.46%200.86-2.87%201.89-3.82%22%2F%3E%0A%3Cpath%20d%3D%22m251.76%20199.83c0.33-0.36%200.53-0.82%200.53-1.33%200-0.5-0.19-0.97-0.51-1.32%200%200%200.89-0.67%201.9-1.12%200.76-0.35%202.17-0.59%202.6-0.67%200.42-0.08%201.26-0.24%201.26-0.24s-0.02%200.2-0.19%200.67c-0.2%200.56-0.4%200.93-0.4%200.93%201.47%200.08%202.86%200.81%203.81%201.76-0.95%200.94-2.33%201.66-3.81%201.75%200%200%200.2%200.36%200.4%200.93%200.16%200.46%200.19%200.67%200.19%200.67l-1.26-0.24c-0.43-0.08-1.84-0.32-2.6-0.67-1.01-0.46-1.92-1.11-1.92-1.11%22%2F%3E%0A%3Cellipse%20fill%3D%22%23ad1519%22%20cx%3D%22250.14%22%20cy%3D%22198.5%22%20rx%3D%222.17%22%20ry%3D%222.06%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m262.58%20201.77c0.11-0.87-0.3-1.63-0.93-1.7s-1.23%200.57-1.34%201.44c-0.11%200.86%200.31%201.63%200.93%201.7%200.63%200.07%201.23-0.57%201.34-1.44%22%2F%3E%0A%3Cpath%20d%3D%22m271.38%20201.38c-0.22-0.35-0.32-0.79-0.25-1.23%200.09-0.44%200.33-0.81%200.67-1.07%200%200-0.67-0.71-1.47-1.26-0.61-0.41-1.8-0.82-2.16-0.95-0.35-0.13-1.06-0.4-1.06-0.4s-0.01%200.18%200.06%200.61c0.08%200.52%200.19%200.87%200.19%200.87-1.29-0.14-2.61%200.29-3.6%200.98%200.68%200.97%201.77%201.79%203.03%202.08%200%200-0.23%200.28-0.49%200.74-0.22%200.39-0.28%200.56-0.28%200.56l1.14-0.03c0.38%200%201.66-0.01%202.37-0.2%200.95-0.25%201.84-0.69%201.84-0.69%22%2F%3E%0A%3Cpath%20d%3D%22m274.67%20191.65c-1.06%200.67-1.98%201.79-2.31%203.03%200%200-0.12-0.25-0.71-0.59-0.58-0.33-1.09-0.32-1.09-0.32s0.17%200.97%200.26%201.32c0.09%200.34%200.09%201.38%200.31%202.32%200.23%200.93%200.64%201.68%200.64%201.68%200.42-0.34%200.99-0.51%201.57-0.41%200.59%200.1%201.06%200.44%201.33%200.9%200%200%200.66-0.58%201.21-1.38%200.54-0.81%200.92-1.78%201.12-2.08%200.21-0.3%200.72-1.15%200.72-1.15s-0.47-0.18-1.14-0.05c-0.67%200.12-0.88%200.32-0.88%200.32%200.15-1.28-0.28-2.62-1.03-3.59%22%2F%3E%0A%3Cpath%20d%3D%22m274.22%20201.86c0.34-0.27%200.6-0.64%200.67-1.08%200.09-0.44%200-0.87-0.22-1.23%200%200%200.88-0.44%201.83-0.69%200.72-0.19%201.99-0.2%202.36-0.2%200.39-0.02%201.15-0.03%201.15-0.03s-0.06%200.17-0.28%200.55c-0.26%200.46-0.49%200.75-0.49%200.75%201.26%200.29%202.34%201.12%203.03%202.09-0.99%200.68-2.31%201.1-3.6%200.97%200%200%200.11%200.34%200.19%200.86%200.06%200.43%200.06%200.61%200.06%200.61s-0.71-0.26-1.06-0.39c-0.36-0.13-1.55-0.55-2.16-0.96-0.79-0.54-1.48-1.25-1.48-1.25%22%2F%3E%0A%3Cellipse%20fill%3D%22%23ad1519%22%20cx%3D%22272.98%22%20cy%3D%22200.45%22%20rx%3D%222.17%22%20ry%3D%222.06%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m283.96%20205.91c0.28-0.83%200.03-1.65-0.57-1.83-0.6-0.19-1.32%200.33-1.61%201.16-0.28%200.83-0.03%201.65%200.57%201.84%200.6%200.18%201.32-0.34%201.61-1.17%22%2F%3E%0A%3Cpath%20d%3D%22m291.97%20206.32c0.11-0.37%200.36-0.75%200.72-1.06%200.79-0.68%201.85-0.79%202.36-0.25%200.07%200.07%200.14%200.17%200.18%200.25%200%200%201.1-2.08%202.4-2.78s3.5-0.52%203.5-0.52c0-1.6-1.31-2.89-3-2.89-0.99%200-1.92%200.41-2.47%201.11l-0.23-1.07s-1.36%200.27-1.98%201.82%200.05%203.8%200.05%203.8-0.33-0.96-0.84-1.61c-0.51-0.64-1.81-1.34-2.49-1.66-0.68-0.31-1.37-0.79-1.37-0.79s-0.03%200.18-0.06%200.61c-0.02%200.51%200.02%200.83%200.02%200.83-1.25-0.17-2.7%200.04-3.83%200.48%200.48%200.95%201.4%201.84%202.61%202.3%200%200-0.43%200.36-0.83%200.75-0.33%200.34-0.43%200.49-0.43%200.49s0.85%200.13%201.27%200.19c0.43%200.05%201.84%200.28%202.68%200.22%200.63-0.04%201.32-0.14%201.74-0.22%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m295.05%20205.01c-0.51-0.54-1.57-0.43-2.36%200.25-0.79%200.67-1.02%201.66-0.51%202.19%200.51%200.54%201.57%200.42%202.36-0.25%200.79-0.68%201.02-1.66%200.51-2.19%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22none%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20stroke-linejoin%3D%22round%22%20d%3D%22m250.12%20224.57c-11.06-0.01-21.07-1.29-28.68-3.26%207.61-1.97%2017.62-3.17%2028.68-3.19%2011.07%200.02%2021.13%201.22%2028.74%203.19-7.61%201.97-17.67%203.25-28.74%203.26z%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.05%22%20d%3D%22m258.04%20224.28v-6.01m-3.02%206.21l0.04-6.37m-2.24%206.45v-6.49%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.09%22%20d%3D%22m250.95%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.14%22%20d%3D%22m249.16%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.18%22%20d%3D%22m247.48%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.23%22%20d%3D%22m245.81%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.28%22%20d%3D%22m244.32%20224.64v-6.57%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.33%22%20d%3D%22m241.48%20224.28l-0.04-5.97m1.39%206.05v-6.25%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.37%22%20d%3D%22m238.86%20224.01v-5.5m1.33%205.66l-0.04-5.86%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.42%22%20d%3D%22m235.35%20223.7v-4.84m1.15%204.92v-5.08m1.19%205.24v-5.28%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.46%22%20d%3D%22m234.12%20223.66v-4.68%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.51%22%20d%3D%22m232.97%20223.42v-4.36%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.56%22%20d%3D%22m231.74%20223.31v-4.06%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.6%22%20d%3D%22m229.22%20222.95l-0.04-3.22m1.33%203.38v-3.62%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.63%22%20d%3D%22m227.93%20222.68v-2.84%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.68%22%20d%3D%22m226.74%20222.45v-2.36%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.73%22%20d%3D%22m225.45%20222.13v-1.85%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.77%22%20d%3D%22m224.12%20221.98v-1.38%22%2F%3E%0A%3Cpath%20stroke-width%3D%220.91%22%20d%3D%22m222.72%20221.66v-0.67%22%2F%3E%0A%3Cpath%20d%3D%22m220.12%20221.66c7.75-2.18%2018.29-3.52%2030-3.54%2011.72%200.02%2022.31%201.36%2030.06%203.54%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m216.72%20217.16l1.22-1.59%203.37%200.43-2.69%201.96-1.9-0.8%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m224.03%20215.28c0-0.58%200.49-1.04%201.1-1.04s1.1%200.46%201.1%201.04c0%200.57-0.49%201.04-1.1%201.04s-1.1-0.47-1.1-1.04%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m233.64%20215.07l-2.36%200.27c-0.61%200.07-1.17-0.33-1.24-0.9-0.08-0.57%200.35-1.09%200.96-1.15l2.37-0.28%202.42-0.28c0.6-0.07%201.15%200.33%201.22%200.9s-0.36%201.09-0.96%201.16l-2.41%200.28%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m240.54%20213.35c0-0.58%200.49-1.04%201.1-1.04%200.6%200%201.1%200.46%201.1%201.04%200%200.57-0.5%201.04-1.1%201.04-0.61%200-1.1-0.47-1.1-1.04%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m250.15%20214.16h-3.29c-0.6%200-1.11-0.46-1.11-1.03%200-0.58%200.49-1.04%201.1-1.04h6.64c0.61%200%201.1%200.46%201.1%201.04%200%200.57-0.51%201.03-1.11%201.03h-3.33%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m257.56%20213.35c0-0.58%200.5-1.04%201.1-1.04%200.61%200%201.1%200.46%201.1%201.04%200%200.57-0.49%201.04-1.1%201.04-0.6%200-1.1-0.47-1.1-1.04%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m266.66%20215.07l2.36%200.27c0.6%200.07%201.17-0.33%201.24-0.9s-0.36-1.09-0.96-1.15l-2.37-0.28-2.42-0.28c-0.61-0.07-1.15%200.33-1.22%200.9-0.08%200.57%200.36%201.09%200.96%201.16l2.41%200.28%22%2F%3E%0A%3Cpath%20fill%3D%22%23fff%22%20d%3D%22m274.07%20215.28c0-0.58%200.49-1.04%201.1-1.04s1.1%200.46%201.1%201.04c0%200.57-0.49%201.04-1.1%201.04s-1.1-0.47-1.1-1.04%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m283.57%20217.16l-1.21-1.59-3.37%200.43%202.69%201.96%201.89-0.8%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22shield%22%20stroke-width%3D%220.52%22%3E%0A%3Cg%20id%3D%22Granada%22%3E%0A%3Cpath%20fill%3D%22%23ccc%22%20d%3D%22m250.49%20344.33c-13.08%200-26.05-3.2-36.95-8.54-8.03-3.98-13.36-12-13.36-21.19v-33.3h100.42v33.3c0%209.19-5.32%2017.21-13.36%2021.19-10.9%205.34-23.66%208.54-36.75%208.54z%22%2F%3E%0A%3Cpath%20fill%3D%22%23ffd691%22%20d%3D%22m252.91%20329.55c2.09%200.63%203.15%202.19%203.15%204.01%200%202.38-2.3%204.18-5.3%204.18-2.99%200-5.42-1.8-5.42-4.18%200-1.79%201-3.8%203.08-3.94%200%200-0.06-0.19-0.24-0.5-0.22-0.23-0.64-0.66-0.64-0.66s0.79-0.15%201.25%200.02c0.46%200.18%200.77%200.47%200.77%200.47s0.21-0.43%200.52-0.76c0.3-0.33%200.7-0.53%200.7-0.53s0.46%200.38%200.61%200.64c0.15%200.27%200.25%200.59%200.25%200.59s0.42-0.35%200.79-0.49c0.37-0.15%200.84-0.26%200.84-0.26s-0.13%200.46-0.22%200.69-0.14%200.72-0.14%200.72%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m250.32%20340.32s-3.98-2.68-5.7-3.04c-2.21-0.47-4.69-0.09-5.76-0.15%200.03%200.03%201.29%200.93%201.84%201.48s2.39%201.65%203.43%201.91c3.22%200.81%206.19-0.2%206.19-0.2%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m251.46%20340.56s2.54-2.66%205.21-3.02c3.15-0.44%205.22%200.26%206.44%200.58%200.03%200-1.01%200.49-1.56%200.87-0.55%200.37-1.97%201.57-4.14%201.59-2.18%200.03-4.58-0.23-4.97-0.17-0.4%200.06-0.98%200.15-0.98%200.15%22%2F%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m250.69%20337.28c-1-0.93-1.62-2.25-1.62-3.72%200-1.46%200.62-2.78%201.63-3.71%200.99%200.93%201.61%202.25%201.61%203.71%200%201.47-0.62%202.79-1.62%203.72%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20d%3D%22m249.68%20342.71s0.61-1.52%200.67-2.83c0.06-1.09-0.15-2.17-0.15-2.17h0.52%200.28s0.39%201.16%200.39%202.17c0%201.02-0.18%202.37-0.18%202.37s-0.55%200.08-0.73%200.17c-0.19%200.09-0.8%200.29-0.8%200.29%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22Aragon%22%20fill%3D%22%23c8b100%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m250.32%20314.57c0%2013.16-11.16%2023.82-25.05%2023.82s-25.15-10.66-25.15-23.82v-33.35h50.2v33.35%22%2F%3E%0A%3Cpath%20d%3D%22m200.03%20314.12c0.15%207.02%202.95%2012.25%205.73%2015.67v-49.47h-5.66l-0.07%2033.8z%22%2F%3E%0A%3Cpath%20d%3D%22m211.08%20334.23c1.57%200.83%203.72%202.22%206.03%202.77l-0.15-56.96h-5.88v54.19z%22%2F%3E%0A%3Cpath%20d%3D%22m222.28%20338.25c2.3%200.23%204.01%200.19%205.87%200v-58.21h-5.87v58.21z%22%2F%3E%0A%3Cpath%20d%3D%22m233.32%20337c2.3-0.46%204.9-1.89%206.03-2.63v-54.33h-5.88l-0.15%2056.96z%22%2F%3E%0A%3Cpath%20d%3D%22m244.81%20329.24c2.45-2.18%204.75-7.12%205.59-12.76l0.14-36.44h-5.87l0.14%2049.2z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22Navarre%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20d%3D%22m300.65%20281.22v33.35c0%2013.16-11.28%2023.82-25.17%2023.82-13.9%200-25.16-10.66-25.16-23.82v-33.35h50.33%22%2F%3E%0A%3Cpath%20id%3D%22chains_half%22%20fill%3D%22%23c8b100%22%20stroke%3D%22%23c8b100%22%20stroke-width%3D%220.26%22%20d%3D%22m272.71%2C306.14c0.05-0.14%2C0.12-0.27%2C0.19-0.4l-4.26-4.74-1.67%2C0.72-3.06-3.39%2C1-1.46-5.34-5.99c-0.07%2C0.02-0.2%2C0.02-0.27%2C0.04l0.03%2C4.02%2C1.75%2C0.5v4.46l-1.75%2C0.48-0.03%2C4.08c0.84%2C0.26%2C1.48%2C0.88%2C1.74%2C1.67l3.21%2C0.01%2C0.51-1.67h4.72l0.5%2C1.67zm-6.98-18.5%2C0%2C1.61%2C2.76%2C0%2C0-1.61zm-7.3%2C20.37c0.64%2C0%2C1.16-0.49%2C1.16-1.1s-0.52-1.11-1.16-1.11c-0.65%2C0-1.17%2C0.5-1.17%2C1.11s0.52%2C1.1%2C1.17%2C1.1zm15.99-9.73-1.76-0.48%2C0-4.46%2C1.76-0.5-0.01-1.92c-0.85-0.25-1.51-0.87-1.79-1.67h-2.68l-0.51%2C1.67h-4.71l-0.51-1.67h-3.09c-0.08%2C0.22-0.17%2C0.42-0.29%2C0.61l5.38%2C5.96%2C1.67-0.71%2C3.06%2C3.4-1%2C1.45%2C4.18%2C4.64c0.09-0.04%2C0.18-0.08%2C0.28-0.12zm-7.25-1.39-1.29%2C1.04%2C1.77%2C1.98%2C1.29-1.05zm8.00432%2C36.1859c-1.23998-0.065-2.25509-0.9022-2.51432-2.01593-1.67-0.23-3.25-0.66-4.73-1.3l0.84-1.43c1.29%2C0.55%2C2.66%2C0.91%2C4.08%2C1.11%2C0.31-0.66%2C0.86-1.16%2C1.58-1.4l0.01-5.62-1.76-0.49v-4.46l1.76-0.48v-7.64c-0.07-0.02-0.13-0.05-0.2-0.09l-3.98%2C4.42%2C1%2C1.44-3.06%2C3.4-1.67-0.71-3.3%2C3.67c0.57%2C0.87%2C0.55%2C2-0.11%2C2.85%2C0.94%2C1.05%2C2.03%2C1.98%2C3.24%2C2.75l-0.84%2C1.44c-1.42-0.89-2.7-1.99-3.79-3.22-0.87%2C0.26-1.86%2C0.11-2.6-0.5-1.15-0.93-1.29-2.56-0.3-3.64l0.14-0.16c-0.69-1.56-1.16-3.24-1.32-5l1.71%2C0.01c0.14%2C1.5%2C0.51%2C2.93%2C1.09%2C4.27%2C0.49-0.06%2C1-0.01%2C1.46%2C0.16l3.32-3.68-1-1.45%2C3.06-3.4%2C1.67%2C0.72%2C3.99-4.43c-0.09-0.14-0.15-0.29-0.21-0.46l-2.76%2C0.01-0.5%2C1.67h-4.72l-0.51-1.67-3.24-0.01c-0.27%2C0.76-0.9%2C1.36-1.69%2C1.62l-0.01%2C4.04-1.71-0.01v-4.01c-1.1-0.33-1.91-1.31-1.91-2.47%2C0-1.15%2C0.82-2.15%2C1.92-2.48l0.01-4.05-1.76-0.48v-4.46l1.76-0.5v-4.05c-1.08-0.35-1.84-1.32-1.84-2.45%2C0-1.43%2C1.22-2.58%2C2.73-2.58%2C1.22%2C0%2C2.25%2C0.74%2C2.61%2C1.78h3.09l0.51-1.67h4.71l0.51%2C1.67h2.68c0.35692-1.0311%2C1.36258-1.76731%2C2.55896-1.77984l0.0711%2C8.36984h-0.85v2.61h0.845l-0.0214%2C21.59h-0.7836v2.61h0.77946zm-5.914-18.306l-1.29-1.04-1.78%2C1.98%2C1.29%2C1.04zm-9.96-18.44-1.69%2C0-0.01%2C2.61%2C1.7%2C0zm9.16%2C11.41%2C0-1.6-2.85%2C0%2C0%2C1.6zm-10.6%2C9.69-1.76-0.39-0.25-4.45%2C1.75-0.58%2C0%2C2.56c0%2C0.99%2C0.09%2C1.92%2C0.26%2C2.86zm1.46-5.52%2C1.75%2C0.41s0.09%2C2.87%2C0.05%2C2.22c-0.04-0.74%2C0.19%2C2.24%2C0.19%2C2.24l-1.76%2C0.58c-0.18-0.9-0.24-1.84-0.24-2.79zm10.81%2C16.93%2C0.39-1.7c-1.52-0.48-2.93-1.18-4.17-2.09l-1.26%2C1.11c1.48%2C1.15%2C3.19%2C2.08%2C5.04%2C2.68zm-0.85%2C1.44-1.3%2C1.22c-1.47-0.54-2.86-1.26-4.12-2.11l0.38-1.77c1.5%2C1.13%2C3.21%2C2.03%2C5.04%2C2.66z%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23chains_half%22%20transform%3D%22matrix(-1%2C0%2C0%2C1%2C550.43%2C0)%22%2F%3E%0A%3Cpath%20fill%3D%22%23058e6e%22%20stroke%3D%22none%22%20d%3D%22m272.59%20306.94c0-1.44%201.23-2.6%202.74-2.6s2.73%201.16%202.73%202.6c0%201.43-1.22%202.58-2.73%202.58s-2.74-1.15-2.74-2.58%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22Castile%22%20fill%3D%22%23c8b100%22%20stroke-width%3D%220.46%22%3E%0A%3Cpath%20fill%3D%22%23ad1519%22%20stroke-width%3D%220.52%22%20d%3D%22m200.12%20281.25h50.18v-55.72h-50.18v55.72z%22%2F%3E%0A%3Cpath%20d%3D%22m217.34%20238.41h-0.92v-0.92h-1.62v3.69h1.62v2.55h-3.47v7.39h1.85v14.79h-3.7v7.63h28.42v-7.63h-3.69v-14.79h1.85v-7.39h-3.47v-2.55h1.62v-3.69h-1.62v0.92h-0.93v-0.92h-1.61v0.92h-1.16v-0.92h-1.62v3.69h1.62v2.55h-3.46v-8.09h1.84v-3.7h-1.84v0.93h-0.93v-0.93h-1.62v0.93h-0.92v-0.93h-1.85v3.7h1.85v8.09h-3.47v-2.55h1.62v-3.69h-1.62v0.92h-0.92v-0.92h-1.85v0.92zm-6.24%2035.13h28.42m-28.42-1.85h28.42m-28.42-1.85h28.42m-28.42-1.85h28.42m-28.42-2.08h28.42m-24.72-1.62h21.03m-21.03-1.85h21.03m-21.03-2.08h21.03m-21.03-1.84h21.03m-21.03-1.85h21.03m-21.03-1.85h21.03m-21.03-1.85h21.03m-22.88-1.85h24.73m-24.73-1.85h24.73m-24.73-1.85h24.73m-24.73-1.84h24.73m-21.26-1.85h17.79m-10.63-1.85h3.47m-3.47-1.85h3.47m-3.47-1.85h3.47m-3.47-1.85h3.47m-5.32-2.31h7.16m-12.47%207.86h3.69m-5.31-2.31h6.93m-6.93%2033.97v-1.85m0-1.85v-1.85m-1.85%201.85v1.85m3.47%200v-1.85m1.84%203.7v-1.85m0-1.85v-1.85m0-2.08v-1.62m0-1.85v-2.08m-1.84%207.63v-2.08m-3.47%202.08v-2.08m7.16%200v2.08m1.62-2.08v-1.62m-5.31-1.85v1.85m3.69-1.85v1.85m3.47-1.85v1.85m-1.85-1.85v-2.08m1.85-1.84v1.84m0-5.54v1.85m-1.85-3.7v1.85m1.85-3.7v1.85m-3.47-1.85v1.85m-3.69-1.85v1.85m-1.62-3.7v1.85m3.46-1.85v1.85m3.47-1.85v1.85m1.85-3.7v1.85m-3.47-1.85v1.85m-3.69-1.85v1.85m-1.62-3.69v1.84m6.93-1.84v1.84m-3.47-5.54v1.85m15.95-1.85h-3.7m5.32-2.31h-6.94m6.94%2033.97v-1.85m0-1.85v-1.85m1.85%201.85v1.85m-3.47%200v-1.85m-1.85%203.7v-1.85m0-1.85v-1.85m0-2.08v-1.62m0-1.85v-2.08m1.85%207.63v-2.08m3.47%202.08v-2.08m-7.17%200v2.08m-1.62-2.08v-1.62m5.32-1.85v1.85m-3.7-1.85v1.85m-3.46-1.85v1.85m1.84-1.85v-2.08m-1.84-1.84v1.84m0-5.54v1.85m1.84-3.7v1.85m-1.84-3.7v1.85m3.46-1.85v1.85m3.7-1.85v1.85m1.62-3.7v1.85m-3.47-1.85v1.85m-3.47-1.85v1.85m-1.84-3.7v1.85m3.46-1.85v1.85m3.7-1.85v1.85m1.62-3.69v1.84m-6.94-1.84v1.84m3.47-5.54v1.85m-7.16%2018.71v-2.08m0-5.54v-1.85m0%205.55v-1.85m0-5.55v-1.85m0-1.85v-1.84m0-3.7v-1.85m0-1.85v-1.85m-8.78%204.85h3.69m3.47-5.54h3.47m3.46%205.54h3.7%22%2F%3E%0A%3Cpath%20d%3D%22m230.05%20273.54v-4.86c0-0.92-0.46-3.7-4.85-3.7-4.16%200-4.62%202.78-4.62%203.7v4.86h9.47z%22%2F%3E%0A%3Cpath%20d%3D%22m222.19%20268.91l-2.31-0.23c0-0.92%200.23-2.31%200.93-2.77l2.08%201.62c-0.23%200.23-0.7%200.92-0.7%201.38z%22%2F%3E%0A%3Cpath%20d%3D%22m226.12%20266.6l1.16-2.08c-0.46-0.23-1.39-0.46-2.08-0.46-0.46%200-1.39%200.23-1.85%200.46l1.15%202.08h1.62z%22%2F%3E%0A%3Cpath%20d%3D%22m228.43%20268.91l2.31-0.23c0-0.92-0.23-2.31-0.92-2.77l-2.08%201.62c0.23%200.23%200.69%200.92%200.69%201.38z%22%2F%3E%0A%3Cpath%20d%3D%22m221.73%20260.83v-5.09c0-1.38-0.92-2.54-2.54-2.54s-2.54%201.16-2.54%202.54v5.09h5.08z%22%2F%3E%0A%3Cpath%20d%3D%22m228.89%20260.83v-5.09c0-1.38%200.93-2.54%202.55-2.54%201.61%200%202.54%201.16%202.54%202.54v5.09h-5.09z%22%2F%3E%0A%3Cpath%20d%3D%22m220.11%20248.35l0.23-4.62h-4.39l0.47%204.62h3.69z%22%2F%3E%0A%3Cpath%20d%3D%22m227.05%20248.35l0.46-4.62h-4.39l0.23%204.62h3.7z%22%2F%3E%0A%3Cpath%20d%3D%22m230.51%20248.35l-0.46-4.62h4.62l-0.46%204.62h-3.7z%22%2F%3E%0A%3Cg%20fill%3D%22%230039f0%22%20stroke%3D%22none%22%3E%0A%3Cpath%20d%3D%22m228.43%20273.54v-4.16c0-0.7-0.46-2.78-3.23-2.78-2.54%200-3.01%202.08-3.01%202.78v4.16h6.24z%22%2F%3E%0A%3Cpath%20d%3D%22m221.27%20260.36v-4.39c0-1.15-0.69-2.31-2.08-2.31s-2.08%201.16-2.08%202.31v4.39h4.16z%22%2F%3E%0A%3Cpath%20d%3D%22m229.36%20260.36v-4.39c0-1.15%200.69-2.31%202.08-2.31%201.38%200%202.08%201.16%202.08%202.31v4.39h-4.16z%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22Leon%22%3E%0A%3Cpath%20fill%3D%22%23ccc%22%20d%3D%22m250.28%20281.25h50.32v-55.72h-50.32v55.72z%22%2F%3E%0A%3Cpath%20fill%3D%22%23db4446%22%20stroke-width%3D%220.39%22%20d%3D%22m275.93%20239.26l0.05-0.62%200.09-0.34s-1.61%200.13-2.46-0.11-1.61-0.59-2.4-1.25c-0.79-0.68-1.1-1.1-1.67-1.18-1.36-0.22-2.4%200.4-2.4%200.4s1.02%200.37%201.78%201.31%201.59%201.41%201.95%201.53c0.59%200.18%202.66%200.05%203.22%200.07%200.57%200.03%201.84%200.19%201.84%200.19z%22%2F%3E%0A%3Cg%20fill%3D%22none%22%20stroke-width%3D%220.39%22%3E%0A%3Cpath%20fill%3D%22%23ed72aa%22%20d%3D%22m283.46%20237s0.01%200.72%200.08%201.4c0.06%200.67-0.22%201.24-0.11%201.61s0.16%200.66%200.3%200.93c0.14%200.26%200.21%200.94%200.21%200.94s-0.38-0.28-0.74-0.54c-0.35-0.27-0.6-0.44-0.6-0.44s0.07%200.72%200.1%201.03c0.04%200.31%200.22%200.89%200.51%201.24%200.29%200.33%200.87%200.89%201.05%201.33%200.18%200.45%200.14%201.44%200.14%201.44s-0.46-0.75-0.87-0.89c-0.39-0.14-1.26-0.62-1.26-0.62s0.79%200.79%200.79%201.55c0%200.75-0.32%201.6-0.32%201.6s-0.36-0.68-0.83-1.12c-0.47-0.45-1.13-0.9-1.13-0.9s0.52%201.17%200.52%201.95c0%200.79-0.15%202.47-0.15%202.47s-0.39-0.64-0.79-0.96c-0.4-0.31-0.87-0.58-1.02-0.78-0.14-0.21%200.48%200.64%200.54%201.16%200.07%200.51%200.32%202.35%201.92%204.69%200.94%201.37%202.39%203.77%205.5%202.98%203.11-0.78%201.96-4.97%201.3-6.92-0.65-1.95-0.98-4.11-0.94-4.87%200.04-0.75%200.58-2.97%200.51-3.39-0.07-0.41-0.24-2%200.14-3.28%200.4-1.33%200.73-1.85%200.95-2.4%200.21-0.55%200.39-0.86%200.46-1.34s0.07-1.37%200.07-1.37%200.58%201.06%200.73%201.44c0.14%200.38%200.14%201.5%200.14%201.5s0.11-1.12%200.98-1.67%201.88-1.13%202.13-1.44%200.33-0.51%200.33-0.51-0.08%201.92-0.62%202.67c-0.36%200.49-1.77%202.09-1.77%202.09s0.73-0.28%201.23-0.3c0.51-0.04%200.87%200%200.87%200s-0.62%200.48-1.41%201.64c-0.8%201.16-0.47%201.26-1.05%202.22s-1.05%201-1.78%201.58c-1.08%200.87-0.5%204.34-0.36%204.86%200.15%200.51%202.03%204.76%202.07%205.79%200.03%201.03%200.21%203.33-1.6%204.8-1.16%200.95-3.07%200.96-3.51%201.23-0.43%200.28-1.29%201.13-1.29%202.91%200%201.79%200.64%202.06%201.15%202.51%200.51%200.44%201.16%200.2%201.3%200.55%200.15%200.34%200.22%200.54%200.44%200.75%200.21%200.2%200.36%200.44%200.29%200.82-0.08%200.38-0.91%201.23-1.2%201.85-0.29%200.61-0.87%202.23-0.87%202.47s-0.07%200.99%200.18%201.37c0%200%200.91%201.06%200.29%201.26-0.4%200.14-0.78-0.25-0.97-0.2-0.54%200.14-0.83%200.47-0.98%200.45-0.36-0.07-0.36-0.25-0.4-0.76-0.03-0.51-0.01-0.72-0.17-0.72-0.22%200-0.33%200.18-0.37%200.45s-0.04%200.89-0.29%200.89-0.61-0.45-0.83-0.55-0.83-0.2-0.87-0.48c-0.03-0.27%200.36-0.85%200.76-0.96%200.4-0.1%200.76-0.3%200.51-0.51-0.26-0.2-0.51-0.2-0.76%200-0.25%200.21-0.79%200.04-0.76-0.27%200.04-0.31%200.11-0.69%200.07-0.86-0.03-0.17-0.47-0.51%200.1-0.82%200.59-0.31%200.84%200.27%201.42%200.17s0.86-0.31%201.08-0.65%200.18-1.06-0.22-1.5c-0.39-0.45-0.79-0.52-0.94-0.8-0.14-0.27-0.36-0.92-0.36-0.92s0.11%201.2%200.04%201.37-0.04%200.89-0.04%200.89-0.39-0.45-0.72-0.79c-0.32-0.34-0.65-1.37-0.65-1.37s-0.03%200.96-0.03%201.34c0%200.37%200.43%200.72%200.29%200.86-0.15%200.13-0.83-0.72-1.02-0.86-0.18-0.14-0.76-0.58-1.01-1.06s-0.44-1.16-0.51-1.41c-0.07-0.24-0.19-1.31-0.07-1.58%200.18-0.4%200.47-1.13%200.47-1.13h-1.41c-0.76%200-1.3-0.23-1.59%200.28s-0.15%201.54%200.21%202.88c0.37%201.33%200.58%201.98%200.48%202.22-0.11%200.24-0.58%200.79-0.76%200.89-0.19%200.11-0.69%200.07-0.91-0.03-0.21-0.1-0.57-0.27-1.26-0.27s-1.12%200.03-1.37-0.03c-0.26-0.07-0.88-0.38-1.17-0.31s-0.79%200.32-0.65%200.72c0.22%200.61-0.21%200.75-0.51%200.72-0.29-0.04-0.53-0.14-0.9-0.24-0.36-0.11-0.9%200-0.83-0.42%200.07-0.41%200.22-0.44%200.4-0.74%200.18-0.32%200.25-0.52%200.04-0.54-0.25-0.02-0.51-0.05-0.7%200.11-0.2%200.16-0.51%200.51-0.76%200.38-0.26-0.14-0.46-0.43-0.46-1.08%200-0.64-0.68-1.2-0.05-1.17%200.62%200.03%201.41%200.48%201.55%200.13s0.06-0.51-0.28-0.78-0.76-0.43-0.31-0.77c0.45-0.35%200.56-0.35%200.74-0.54%200.17-0.18%200.41-0.79%200.73-0.64%200.62%200.3%200.02%200.73%200.65%201.42%200.62%200.69%201.01%200.94%202.06%200.83%201.04-0.11%201.33-0.24%201.33-0.54%200-0.29-0.09-0.82-0.12-1.04-0.02-0.21%200.15-0.99%200.15-0.99s-0.48%200.3-0.63%200.59c-0.13%200.29-0.42%200.8-0.42%200.8s-0.11-0.6-0.08-1.09c0.02-0.29%200.12-0.79%200.11-0.89-0.03-0.27-0.23-0.94-0.23-0.94s-0.16%200.73-0.28%200.94c-0.11%200.21-0.16%201.07-0.16%201.07s-0.67-0.58-0.48-1.55c0.13-0.75-0.12-1.74%200.11-2.06%200.22-0.33%200.75-1.64%202.06-1.69%201.3-0.05%202.31%200.05%202.77%200.03%200.45-0.03%202.06-0.33%202.06-0.33s-2.97-1.52-3.64-1.98c-0.68-0.45-1.73-1.63-2.07-2.16-0.34-0.54-0.65-1.58-0.65-1.58s-0.53%200.02-1.02%200.29c-0.48%200.27-0.96%200.67-1.24%200.99s-0.73%201.05-0.73%201.05%200.08-0.94%200.08-1.23-0.06-0.86-0.06-0.86-0.33%201.28-1.01%201.76c-0.68%200.49-1.47%201.15-1.47%201.15s0.08-0.71%200.08-0.88c0-0.16%200.17-0.99%200.17-0.99s-0.48%200.72-1.21%200.86c-0.74%200.13-1.81%200.11-1.9%200.56-0.08%200.45%200.2%201.07%200.03%201.39s-0.54%200.54-0.54%200.54-0.42-0.35-0.79-0.38c-0.36-0.03-0.71%200.16-0.71%200.16s-0.31-0.4-0.19-0.67c0.11-0.26%200.67-0.66%200.54-0.83-0.15-0.16-0.6%200.06-0.88%200.19-0.28%200.14-0.88%200.27-0.82-0.19%200.05-0.45%200.2-0.72%200.05-1.04-0.14-0.32-0.05-0.53%200.18-0.61%200.22-0.08%201.12%200.02%201.21-0.19%200.08-0.21-0.22-0.48-0.82-0.61-0.59-0.14-0.88-0.49-0.57-0.78%200.32-0.3%200.4-0.38%200.54-0.64%200.14-0.27%200.2-0.76%200.74-0.51%200.53%200.24%200.42%200.83%200.99%201.01%200.56%200.19%201.89-0.08%202.17-0.24s1.19-0.83%201.5-0.99c0.31-0.15%201.61-1.12%201.61-1.12s-0.76-0.53-1.05-0.8c-0.28-0.27-0.78-0.91-1.04-1.05-0.25-0.13-1.5-0.61-1.92-0.64-0.42-0.02-1.72-0.48-1.72-0.48s0.59-0.19%200.79-0.35c0.19-0.16%200.64-0.56%200.87-0.53%200.22%200.02%200.28%200.02%200.28%200.02s-1.21-0.05-1.47-0.13c-0.25-0.08-0.99-0.54-1.27-0.54s-0.84%200.11-0.84%200.11%200.76-0.48%201.38-0.59c0.62-0.1%201.1-0.08%201.1-0.08s-0.96-0.27-1.19-0.58c-0.22-0.33-0.45-0.8-0.62-1.02-0.17-0.21-0.28-0.56-0.59-0.59s-0.85%200.38-1.16%200.35-0.54-0.22-0.57-0.67c-0.02-0.46%200-0.3-0.1-0.54-0.12-0.24-0.57-0.8-0.15-0.93%200.43-0.14%201.33%200.08%201.42-0.08%200.08-0.16-0.48-0.65-0.85-0.83-0.37-0.19-0.96-0.51-0.65-0.78%200.31-0.26%200.62-0.37%200.79-0.61s0.37-0.91%200.74-0.7c0.36%200.21%200.87%201.26%201.16%201.18%200.28-0.08%200.3-0.83%200.25-1.15-0.06-0.32%200-0.88%200.28-0.83s0.51%200.43%200.96%200.46c0.45%200.02%201.13-0.11%201.07%200.21-0.05%200.32-0.31%200.71-0.62%201.06-0.3%200.36-0.45%201.05-0.25%201.5%200.2%200.46%200.71%201.19%201.16%201.48s1.3%200.51%201.84%200.85c0.53%200.35%201.78%201.34%202.2%201.45s0.85%200.32%200.85%200.32%200.48-0.21%201.13-0.21%202.14%200.1%202.71-0.14%201.3-0.64%201.08-1.15c-0.23-0.51-1.47-0.96-1.36-1.36s0.57-0.43%201.33-0.46c0.76-0.02%201.8%200.14%202-0.94%200.2-1.06%200.26-1.68-0.81-1.92-1.08-0.24-1.87-0.27-2.07-1.04-0.2-0.78-0.39-0.97-0.17-1.18%200.23-0.21%200.62-0.32%201.41-0.37%200.8-0.06%201.7-0.06%201.96-0.25%200.25-0.18%200.3-0.69%200.61-0.91%200.31-0.21%201.53-0.4%201.53-0.4s1.46%200.71%202.8%201.71c1.21%200.9%202.3%202.23%202.3%202.23%22%2F%3E%0A%3Cpath%20d%3D%22m269%20243.39s-0.8%200.23-1.1%200.67c-0.37%200.53-0.34%201.07-0.34%201.07s0.68-0.56%201.56-0.33c0.87%200.24%200.96%200.33%201.33%200.3s1.27-0.35%201.27-0.35-0.74%200.86-0.65%201.45c0.08%200.58%200.19%200.85%200.17%201.15-0.06%200.72-0.6%201.61-0.6%201.61s0.31-0.19%201.05-0.35c0.73-0.16%201.36-0.51%201.75-0.81%200.39-0.29%200.9-1.02%200.9-1.02s-0.16%201%200%201.42c0.17%200.44%200.23%201.67%200.23%201.67s0.47-0.42%200.85-0.62c0.19-0.11%200.7-0.38%200.9-0.7%200.14-0.22%200.32-1.06%200.32-1.06s0.11%200.9%200.39%201.34c0.28%200.42%200.7%201.74%200.7%201.74s0.29-0.86%200.6-1.21%200.68-0.8%200.7-1.07c0.03-0.27-0.08-0.85-0.08-0.85l0.39%200.85m-11.41%200.61s0.48-0.83%200.93-1.1c0.46-0.26%201.08-0.74%201.25-0.8%200.16-0.05%200.9-0.46%200.9-0.46m0.99%205.17s1.09-0.55%201.41-0.75c0.68-0.4%201.16-1.12%201.16-1.12%22%2F%3E%0A%3Cpath%20fill%3D%22none%22%20stroke-width%3D%220.26%22%20d%3D%22m282.57%20240.9s-0.34-0.48-0.42-0.65c-0.09-0.15-0.23-0.48-0.23-0.48%22%2F%3E%0A%3Cpath%20fill%3D%22none%22%20d%3D%22m278.33%20257.41s2.04%201.26%201.98%202.31c-0.06%201.04-1.13%202.41-1.13%202.41%22%2F%3E%0A%3C%2Fg%3E%0A%3Cpath%20fill%3D%22%23000%22%20stroke-width%3D%220.26%22%20d%3D%22m273.05%20236.24s-0.17-0.48-0.2-0.62c-0.03-0.13-0.12-0.29-0.12-0.29s0.88%200%200.85%200.27c-0.02%200.27-0.28%200.27-0.34%200.37-0.05%200.11-0.19%200.27-0.19%200.27z%22%2F%3E%0A%3Cpath%20fill%3D%22%23000%22%20stroke-width%3D%220.05%22%20d%3D%22m277.06%20234.85l-0.06-0.43s0.77%200%201.13%200.26c0.57%200.4%200.93%201.02%200.91%201.05-0.1%200.09-0.54-0.27-0.85-0.37%200%200-0.23%200.05-0.45%200.05-0.23%200-0.34-0.11-0.37-0.21-0.03-0.12%200.03-0.3%200.03-0.3l-0.34-0.05z%22%2F%3E%0A%3Cg%20fill%3D%22%23000%22%20stroke-width%3D%220.26%22%3E%0A%3Cpath%20d%3D%22m273.08%20240.14l0.33-0.53%200.34%200.49-0.67%200.04%22%2F%3E%0A%3Cpath%20d%3D%22m273.89%20240.12l0.4-0.53%200.43%200.48-0.83%200.05%22%2F%3E%0A%3Cpath%20d%3D%22m273.53%20236.83l0.82%200.29-0.74%200.38-0.08-0.67%22%2F%3E%0A%3Cpath%20d%3D%22m274.52%20237.1l0.73%200.18-0.59%200.46-0.14-0.64%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22%23db4446%22%20stroke-width%3D%220.39%22%3E%0A%3Cpath%20d%3D%22m261.88%20236.08s0.48%200.34%200.85%200.4c0.37%200.05%200.76%200.05%200.82%200.05%200.05%200%200.17-0.54%200.11-0.91-0.2-1.2-1.3-1.47-1.3-1.47s0.33%200.73%200.17%201.07c-0.23%200.48-0.65%200.86-0.65%200.86z%22%2F%3E%0A%3Cpath%20d%3D%22m259.59%20237.12s-0.43-0.77-1.33-0.67c-0.9%200.11-1.5%200.81-1.5%200.81s1-0.03%201.25%200.13c0.37%200.24%200.48%200.86%200.48%200.86s0.54-0.32%200.71-0.54c0.16-0.21%200.39-0.59%200.39-0.59z%22%2F%3E%0A%3Cpath%20d%3D%22m258.49%20240.25s-0.77%200.11-1.19%200.59c-0.43%200.49-0.36%201.4-0.36%201.4s0.5-0.54%200.95-0.54c0.46%200%201.16%200.16%201.16%200.16s-0.22-0.56-0.22-0.8-0.34-0.81-0.34-0.81z%22%2F%3E%0A%3Cpath%20d%3D%22m261.06%20250.37s-0.42-0.45-1.16-0.32c-0.74%200.14-1.22%200.97-1.22%200.97s0.63-0.17%201-0.08c0.36%200.08%200.62%200.45%200.62%200.45s0.34-0.29%200.45-0.45%200.31-0.57%200.31-0.57z%22%2F%3E%0A%3Cpath%20d%3D%22m260.21%20253.34s-0.62-0.1-1.16%200.33c-0.53%200.43-0.56%201.25-0.56%201.25s0.51-0.43%200.91-0.37c0.39%200.05%200.87%200.27%200.87%200.27s0.08-0.51%200.11-0.64c0.09-0.38-0.17-0.84-0.17-0.84z%22%2F%3E%0A%3Cpath%20d%3D%22m261.66%20256.08s-0.05%200.79%200.33%201.28c0.4%200.51%201.13%200.59%201.13%200.59s-0.24-0.53-0.28-0.8c-0.06-0.4%200.34-0.75%200.34-0.75s-0.37-0.38-0.73-0.38c-0.37%200-0.79%200.06-0.79%200.06z%22%2F%3E%0A%3Cpath%20d%3D%22m269%20263.12s-0.51-0.64-1.21-0.62c-0.71%200.03-1.45%200.69-1.45%200.69s0.88-0.07%201.11%200.22c0.23%200.3%200.45%200.67%200.45%200.67s0.4-0.21%200.57-0.35c0.17-0.13%200.53-0.61%200.53-0.61z%22%2F%3E%0A%3Cpath%20d%3D%22m266.83%20265.93s-0.93-0.14-1.39%200.35c-0.45%200.48-0.42%201.36-0.42%201.36s0.56-0.61%201.07-0.56%201.08%200.32%201.08%200.32-0.09-0.53-0.15-0.78c-0.05-0.24-0.19-0.69-0.19-0.69z%22%2F%3E%0A%3Cpath%20d%3D%22m268.84%20268.9s-0.46%200.64-0.12%201.15%201.05%200.75%201.05%200.75-0.26-0.37-0.14-0.8c0.09-0.34%200.67-0.8%200.67-0.8l-1.46-0.3z%22%2F%3E%0A%3Cpath%20d%3D%22m281.24%20270.11s-0.81-0.19-1.27%200.08c-0.45%200.26-0.82%201.39-0.82%201.39s0.74-0.62%201.28-0.54c0.53%200.08%200.93%200.3%200.93%200.3s0.08-0.46%200.02-0.78c-0.03-0.19-0.14-0.45-0.14-0.45z%22%2F%3E%0A%3Cpath%20d%3D%22m281.64%20273.1s-0.62%200.64-0.4%201.18c0.23%200.54%200.62%201.1%200.62%201.1s-0.02-0.8%200.23-1.02c0.37-0.32%201.05-0.37%201.05-0.37s-0.54-0.48-0.71-0.54c-0.17-0.05-0.79-0.35-0.79-0.35z%22%2F%3E%0A%3Cpath%20d%3D%22m284.75%20274.04s-0.31%200.78%200.28%201.28c0.59%200.52%201.11%200.57%201.11%200.57s-0.46-0.81-0.32-1.23c0.15-0.45%200.54-0.72%200.54-0.72s-0.74-0.25-0.85-0.22c-0.11%200.02-0.76%200.32-0.76%200.32z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cg%20fill%3D%22%23c8b100%22%20stroke-width%3D%220.26%22%3E%0A%3Cpath%20d%3D%22m282.88%20232.71l-0.29%200.02c-0.01%200.03-0.14%200.24-0.26%200.35-0.26%200.25-0.65%200.28-0.86%200.07-0.11-0.11-0.16-0.26-0.14-0.41-0.17%200.09-0.35%200.09-0.51-0.01-0.26-0.15-0.32-0.5-0.14-0.79%200.03-0.06%200.06-0.14%200.11-0.18l-0.02-0.32-0.35%200.08-0.1%200.19c-0.22%200.25-0.54%200.31-0.7%200.17-0.08-0.07-0.14-0.26-0.13-0.27%200%200.01-0.09%200.09-0.17%200.11-0.54%200.13-0.75-1.05-0.77-1.35l-0.17%200.25s0.16%200.7%200.08%201.3c-0.08%200.59-0.29%201.19-0.29%201.19%200.74%200.19%201.86%200.8%202.97%201.65s1.98%201.78%202.34%202.42c0%200%200.58-0.32%201.18-0.51s1.36-0.2%201.36-0.2l0.22-0.21c-0.32%200.05-1.58%200.1-1.56-0.43%200-0.08%200.07-0.18%200.08-0.18-0.01%200.01-0.21-0.01-0.3-0.06-0.18-0.13-0.18-0.43%200.02-0.69l0.18-0.13%200.01-0.34-0.34%200.05c-0.03%200.04-0.11%200.09-0.15%200.13-0.27%200.23-0.65%200.25-0.86%200.03-0.13-0.12-0.17-0.29-0.11-0.46-0.16%200.04-0.32%200.03-0.45-0.05-0.26-0.15-0.31-0.52-0.11-0.8%200.09-0.14%200.28-0.31%200.31-0.32l-0.07-0.3h-0.01z%22%2F%3E%0A%3Cg%20fill%3D%22%23000%22%20stroke-width%3D%220.05%22%3E%0A%3Cpath%20d%3D%22m280.63%20233.4c0.05-0.07%200.15-0.06%200.23%200s0.1%200.16%200.06%200.21c-0.05%200.06-0.15%200.06-0.24-0.01-0.07-0.05-0.1-0.15-0.05-0.2z%22%2F%3E%0A%3Cpath%20d%3D%22m281.58%20234.19l-0.33-0.25c-0.06-0.04-0.07-0.12-0.04-0.16%200.04-0.04%200.12-0.04%200.18%200l0.33%200.26%200.33%200.25c0.05%200.04%200.08%200.12%200.04%200.16s-0.12%200.04-0.18%200l-0.33-0.26%22%2F%3E%0A%3Cpath%20d%3D%22m279.84%20233l-0.26-0.15c-0.07-0.04-0.1-0.12-0.07-0.17s0.11-0.06%200.17-0.02l0.26%200.16%200.26%200.15c0.06%200.03%200.09%200.11%200.07%200.16-0.03%200.05-0.11%200.06-0.17%200.02l-0.26-0.15%22%2F%3E%0A%3Cpath%20d%3D%22m278.8%20232.29c0.05-0.06%200.16-0.06%200.24%200%200.08%200.07%200.1%200.16%200.05%200.22-0.05%200.05-0.15%200.05-0.23-0.01s-0.1-0.15-0.06-0.21z%22%2F%3E%0A%3Cpath%20d%3D%22m282.63%20234.92c0.05-0.05%200.03-0.14-0.05-0.21-0.08-0.06-0.19-0.06-0.24%200-0.04%200.05-0.02%200.15%200.06%200.21s0.18%200.06%200.23%200z%22%2F%3E%0A%3Cpath%20d%3D%22m283.2%20235.58l0.22%200.21c0.05%200.05%200.13%200.07%200.18%200.03%200.04-0.04%200.04-0.11-0.01-0.16l-0.21-0.21-0.22-0.21c-0.05-0.05-0.14-0.07-0.18-0.03-0.05%200.03-0.04%200.11%200.01%200.16l0.21%200.21%22%2F%3E%0A%3Cpath%20d%3D%22m284.15%20236.39c0.05-0.06%200.03-0.15-0.05-0.21-0.08-0.07-0.18-0.07-0.23-0.01s-0.03%200.15%200.05%200.22c0.08%200.05%200.18%200.06%200.23%200z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cpath%20d%3D%22m281.4%20230.36l-0.59%200.01-0.11%200.87%200.06%200.14%200.15-0.01%200.76-0.51-0.27-0.5%22%2F%3E%0A%3Cpath%20d%3D%22m281.4%20230.36l-0.59%200.01-0.11%200.87%200.06%200.14%200.15-0.01%200.76-0.51-0.27-0.5%22%2F%3E%0A%3Cpath%20d%3D%22m279.8%20230.84l-0.02%200.54%200.92%200.12%200.15-0.07-0.02-0.15-0.53-0.71-0.5%200.27%22%2F%3E%0A%3Cpath%20d%3D%22m281.7%20231.92l-0.49%200.27-0.54-0.71-0.01-0.15%200.14-0.06%200.93%200.11-0.03%200.54%22%2F%3E%0A%3Cpath%20d%3D%22m280.51%20231.25c0.08-0.13%200.26-0.17%200.39-0.09%200.14%200.07%200.18%200.24%200.1%200.37s-0.26%200.17-0.39%200.09c-0.14-0.08-0.18-0.24-0.1-0.37z%22%2F%3E%0A%3Cpath%20d%3D%22m278.36%20230.35c-0.02%200.01-0.13-0.46-0.26-0.71-0.08-0.19-0.39-0.43-0.39-0.43%200.03-0.05%200.42-0.19%200.87%200.09%200.38%200.31-0.03%200.87-0.03%200.87s-0.09%200.14-0.19%200.18z%22%2F%3E%0A%3Cpath%20d%3D%22m279.39%20230.66l-0.42%200.37-0.68-0.6%200.06-0.08%200.03-0.15%200.92-0.07%200.09%200.53%22%2F%3E%0A%3Cpath%20d%3D%22m278.24%20230.29c0.05-0.15%200.18-0.23%200.28-0.2%200.11%200.04%200.15%200.18%200.1%200.33s-0.18%200.23-0.29%200.2c-0.11-0.04-0.15-0.18-0.09-0.33z%22%2F%3E%0A%3Cpath%20d%3D%22m283.67%20231.77l-0.59-0.06-0.25%200.85%200.05%200.14%200.15%200.01%200.83-0.41-0.19-0.53%22%2F%3E%0A%3Cpath%20d%3D%22m282.01%20232.03l-0.1%200.54%200.9%200.23%200.15-0.04%200.01-0.14-0.43-0.79-0.53%200.2%22%2F%3E%0A%3Cpath%20d%3D%22m283.73%20233.36l-0.53%200.2-0.42-0.78%200.01-0.15%200.15-0.03%200.89%200.23-0.1%200.53%22%2F%3E%0A%3Cpath%20d%3D%22m282.65%20232.54c0.1-0.12%200.28-0.13%200.4-0.04%200.13%200.09%200.15%200.26%200.05%200.38s-0.28%200.13-0.41%200.04c-0.12-0.09-0.14-0.26-0.04-0.38z%22%2F%3E%0A%3Cpath%20d%3D%22m285.64%20233.61l0.11%200.55-0.87%200.3-0.16-0.04-0.01-0.14%200.36-0.81%200.57%200.14%22%2F%3E%0A%3Cpath%20d%3D%22m285.49%20235.2l-0.56%200.13-0.31-0.83%200.04-0.15%200.15-0.02%200.85%200.35-0.17%200.52%22%2F%3E%0A%3Cpath%20d%3D%22m283.97%20233.66l-0.18%200.52%200.85%200.34%200.16-0.02%200.03-0.14-0.3-0.83-0.56%200.13%22%2F%3E%0A%3Cpath%20d%3D%22m284.91%20234.63c0.12-0.11%200.12-0.28%200.02-0.39-0.11-0.11-0.29-0.11-0.41-0.02-0.11%200.11-0.12%200.28-0.01%200.39%200.1%200.11%200.29%200.12%200.4%200.02z%22%2F%3E%0A%3Cpath%20d%3D%22m286.29%20236.43c0%200.01%200.5%200.03%200.79%200.09%200.2%200.04%200.52%200.27%200.52%200.27%200.06-0.04%200.12-0.42-0.28-0.79-0.39-0.28-0.88%200.22-0.88%200.22s-0.12%200.12-0.15%200.21z%22%2F%3E%0A%3Cpath%20d%3D%22m285.75%20235.54l-0.29%200.46%200.76%200.51%200.09-0.08%200.13-0.04-0.12-0.88-0.57%200.03%22%2F%3E%0A%3Cpath%20d%3D%22m286.37%20236.53c0.14-0.07%200.21-0.22%200.15-0.31s-0.22-0.1-0.36-0.02-0.2%200.22-0.14%200.31c0.05%200.09%200.21%200.1%200.35%200.02z%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3Cg%20id%3D%22inescutcheon%22%20stroke-width%3D%220.61%22%3E%0A%3Cellipse%20fill%3D%22%23ad1519%22%20cx%3D%22250.43%22%20cy%3D%22281.01%22%20rx%3D%2216.26%22%20ry%3D%2218.3%22%2F%3E%0A%3Cellipse%20fill%3D%22%23005bbf%22%20cx%3D%22250.44%22%20cy%3D%22280.97%22%20rx%3D%2211.44%22%20ry%3D%2213.42%22%2F%3E%0A%3Cg%20id%3D%22fdl%22%20fill%3D%22%23c8b100%22%20stroke-width%3D%220.34%22%3E%0A%3Cpath%20stroke-linejoin%3D%22round%22%20d%3D%22m245.03%20271.74s-1.35%201.48-1.35%202.86c0%201.39%200.57%202.54%200.57%202.54-0.21-0.55-0.76-0.94-1.41-0.94-0.83%200-1.5%200.63-1.5%201.42%200%200.22%200.14%200.58%200.24%200.77l0.49%200.99c0.16-0.37%200.54-0.57%200.98-0.57%200.59%200%201.08%200.45%201.08%201.01%200%200.09-0.01%200.17-0.04%200.25l-1.22%200.01v1.03h1.09l-0.81%201.61%201.07-0.42%200.81%200.91%200.84-0.91%201.07%200.42-0.8-1.61h1.08v-1.03l-1.22-0.01c-0.02-0.08-0.02-0.16-0.02-0.25%200-0.56%200.47-1.01%201.06-1.01%200.44%200%200.82%200.2%200.98%200.57l0.49-0.99c0.1-0.19%200.24-0.55%200.24-0.77%200-0.79-0.67-1.42-1.49-1.42-0.66%200-1.21%200.39-1.41%200.94%200%200%200.57-1.15%200.57-2.54%200-1.38-1.39-2.86-1.39-2.86z%22%2F%3E%0A%3Cpath%20d%3D%22m242.87%20281.11h4.36v-1.03h-4.36v1.03z%22%2F%3E%0A%3C%2Fg%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23fdl%22%20x%3D%2210.63%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23fdl%22%20x%3D%225.31%22%20y%3D%229.14%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3C%2Fg%3E%0A%3C%2Fsvg%3E)
%22%3E%3Ccircle%20r%3D%2220%22%20fill%3D%22%23008%22%2F%3E%3Ccircle%20r%3D%2217.5%22%20fill%3D%22%23fff%22%2F%3E%3Ccircle%20r%3D%223.5%22%20fill%3D%22%23008%22%2F%3E%3Cg%20id%3D%22d%22%3E%3Cg%20id%3D%22c%22%3E%3Cg%20id%3D%22b%22%3E%3Cg%20id%3D%22a%22%3E%3Ccircle%20r%3D%220.875%22%20fill%3D%22%23008%22%20transform%3D%22rotate(7.5)%20translate(17.5)%22%2F%3E%3Cpath%20fill%3D%22%23008%22%20d%3D%22M%200%2C17.5%200.6%2C7%20C%200.6%2C7%200%2C2%200%2C2%200%2C2%20-0.6%2C7%20-0.6%2C7%20L%200%2C17.5%20z%22%2F%3E%3C%2Fg%3E%3Cuse%20xlink%3Ahref%3D%22%23a%22%20transform%3D%22rotate(15)%22%2F%3E%3C%2Fg%3E%3Cuse%20xlink%3Ahref%3D%22%23b%22%20transform%3D%22rotate(30)%22%2F%3E%3C%2Fg%3E%3Cuse%20xlink%3Ahref%3D%22%23c%22%20transform%3D%22rotate(60)%22%2F%3E%3C%2Fg%3E%3Cuse%20xlink%3Ahref%3D%22%23d%22%20transform%3D%22rotate(120)%22%2F%3E%3Cuse%20xlink%3Ahref%3D%22%23d%22%20transform%3D%22rotate(-120)%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E)
%20-%20http%3A%2F%2Fwww.bohemiancoding.com%2Fsketch%20--%3E%0A%20%20%20%20%3Ctitle%3EInterlingua%20Logo%3C%2Ftitle%3E%0A%20%20%20%20%3Cdesc%3ECreated%20with%20Sketch.%3C%2Fdesc%3E%0A%20%20%20%20%3Cdefs%3E%3C%2Fdefs%3E%0A%20%20%20%20%3Cg%20id%3D%22Page-1%22%20stroke%3D%22none%22%20stroke-width%3D%221%22%20fill%3D%22none%22%20fill-rule%3D%22evenodd%22%20sketch%3Atype%3D%22MSPage%22%3E%0A%20%20%20%20%20%20%20%20%3Cpath%20d%3D%22M607%2C807%20C829.570754%2C807%201010%2C626.570754%201010%2C404%20C1010%2C181.429246%20829.570754%2C1%20607%2C1%20C384.429246%2C1%20204%2C181.429246%20204%2C404%20C204%2C626.570754%20384.429246%2C807%20607%2C807%20Z%20M423.121094%2C116.945312%20C439.794354%2C116.945312%20453.902286%2C122.780866%20465.445312%2C134.452148%20C476.988339%2C146.123431%20482.759766%2C160.167236%20482.759766%2C176.583984%20C482.759766%2C193.000733%20476.924212%2C206.980411%20465.25293%2C218.523438%20C453.581647%2C230.066464%20439.537843%2C235.837891%20423.121094%2C235.837891%20C406.704345%2C235.837891%20392.724667%2C230.066464%20381.181641%2C218.523438%20C369.638614%2C206.980411%20363.867188%2C193.000733%20363.867188%2C176.583984%20C363.867188%2C160.167236%20369.638614%2C146.123431%20381.181641%2C134.452148%20C392.724667%2C122.780866%20406.704345%2C116.945312%20423.121094%2C116.945312%20Z%20M476.988281%2C291.244141%20L476.988281%2C576.355469%20C476.988281%2C601.750127%20479.938122%2C617.974249%20485.837891%2C625.02832%20C491.73766%2C632.082392%20503.280513%2C636.122391%20520.466797%2C637.148438%20L520.466797%2C651%20L326.160156%2C651%20L326.160156%2C637.148438%20C342.063882%2C636.635414%20353.863243%2C632.018273%20361.558594%2C623.296875%20C366.688828%2C617.397106%20369.253906%2C601.750127%20369.253906%2C576.355469%20L369.253906%2C366.273438%20C369.253906%2C340.878779%20366.304066%2C324.654658%20360.404297%2C317.600586%20C354.504528%2C310.546514%20343.089928%2C306.506516%20326.160156%2C305.480469%20L326.160156%2C291.244141%20L476.988281%2C291.244141%20Z%20M754.019531%2C597.902344%20C710.156031%2C636.63561%20670.782075%2C656.001953%20635.896484%2C656.001953%20C615.375548%2C656.001953%20598.317776%2C649.268622%20584.722656%2C635.801758%20C571.127536%2C622.334894%20564.330078%2C605.469502%20564.330078%2C585.205078%20C564.330078%2C557.758326%20576.129439%2C533.069446%20599.728516%2C511.137695%20C623.327592%2C489.205945%20674.757416%2C460.028177%20754.019531%2C423.603516%20L754.019531%2C387.435547%20C754.019531%2C360.245307%20752.544611%2C343.123408%20749.594727%2C336.069336%20C746.644842%2C329.015264%20741.065796%2C322.859076%20732.857422%2C317.600586%20C724.649048%2C312.342096%20715.414765%2C309.712891%20705.154297%2C309.712891%20C688.481036%2C309.712891%20674.757866%2C313.432254%20663.984375%2C320.871094%20C657.315071%2C325.488304%20653.980469%2C330.874969%20653.980469%2C337.03125%20C653.980469%2C342.417996%20657.571579%2C349.0872%20664.753906%2C357.039062%20C674.501351%2C368.069066%20679.375%2C378.714141%20679.375%2C388.974609%20C679.375%2C401.543683%20674.693732%2C412.252885%20665.331055%2C421.102539%20C655.968378%2C429.952193%20643.720128%2C434.376953%20628.585938%2C434.376953%20C612.4257%2C434.376953%20598.894911%2C429.503304%20587.993164%2C419.755859%20C577.091417%2C410.008415%20571.640625%2C398.593815%20571.640625%2C385.511719%20C571.640625%2C367.042876%20578.951099%2C349.407962%20593.572266%2C332.606445%20C608.193432%2C315.804929%20628.585807%2C302.915409%20654.75%2C293.9375%20C680.914193%2C284.959591%20708.104026%2C280.470703%20736.320312%2C280.470703%20C770.436368%2C280.470703%20797.43382%2C287.71705%20817.313477%2C302.209961%20C837.193133%2C316.702872%20850.082653%2C332.413978%20855.982422%2C349.34375%20C859.573586%2C360.117241%20861.369141%2C384.870249%20861.369141%2C423.603516%20L861.369141%2C563.273438%20C861.369141%2C579.690186%20862.01041%2C590.014627%20863.292969%2C594.24707%20C864.575527%2C598.479513%20866.499336%2C601.621735%20869.064453%2C603.673828%20C871.62957%2C605.725922%20874.57941%2C606.751953%20877.914062%2C606.751953%20C884.583367%2C606.751953%20891.380825%2C602.006558%20898.306641%2C592.515625%20L909.849609%2C601.75%20C897.024024%2C620.731866%20883.749743%2C634.519163%20870.026367%2C643.112305%20C856.302991%2C651.705447%20840.720139%2C656.001953%20823.277344%2C656.001953%20C802.756408%2C656.001953%20786.724667%2C651.192431%20775.181641%2C641.573242%20C763.638614%2C631.954053%20756.584648%2C617.397233%20754.019531%2C597.902344%20Z%20M754.019531%2C569.814453%20L754.019531%2C449.382812%20C722.981616%2C467.595143%20699.895909%2C487.08974%20684.761719%2C507.867188%20C674.757762%2C521.718819%20669.755859%2C535.698497%20669.755859%2C549.806641%20C669.755859%2C561.606179%20673.988239%2C571.994747%20682.453125%2C580.972656%20C688.865917%2C587.898472%20697.843692%2C591.361328%20709.386719%2C591.361328%20C722.212304%2C591.361328%20737.089759%2C584.179108%20754.019531%2C569.814453%20Z%22%20id%3D%22Oval-1%22%20fill%3D%22%23000066%22%20sketch%3Atype%3D%22MSShapeGroup%22%3E%3C%2Fpath%3E%0A%20%20%20%20%3C%2Fg%3E%0A%3C%2Fsvg%3E)
%22%3E%3C!--arctan(-3%2F2)--%3E%0A%3Cg%20id%3D%22b2%22%3E%3Cpath%20id%3D%22b%22%20d%3D%22M-6-25H6M-6-22H6M-6-19H6%22%20stroke%3D%22%23000%22%20stroke-width%3D%222%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23b%22%20y%3D%2244%22%2F%3E%3C%2Fg%3E%0A%3Cpath%20stroke%3D%22%23fff%22%20stroke-width%3D%221%22%20d%3D%22M0%2C17v10%22%2F%3E%0A%3Ccircle%20fill%3D%22%23c60c30%22%20r%3D%2212%22%2F%3E%0A%3Cpath%20fill%3D%22%23003478%22%20d%3D%22M0-12A6%2C6%200%200%200%200%2C0A6%2C6%200%200%201%200%2C12A12%2C12%200%200%2C1%200-12Z%22%2F%3E%3C%2Fg%3E%0A%3Cg%20transform%3D%22rotate(-123.6900675)%22%3E%3Cuse%20xlink%3Ahref%3D%22%23b2%22%2F%3E%0A%3Cpath%20stroke%3D%22%23fff%22%20stroke-width%3D%221%22%20d%3D%22M0-23.5v3M0%2C17v3.5M0%2C23.5v3%22%2F%3E%3C%2Fg%3E%3C%2Fsvg%3E)
%22%2F%3E%0A%3C%2Fg%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23castle%22%20x%3D%2245.7138%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23castle3%22%20transform%3D%22matrix(-1%2C0%2C0%2C1%2C479.79195%2C0)%22%2F%3E%0A%3Cg%20id%3D%22quina%22%20fill%3D%22%23fff%22%3E%0A%3Cpath%20fill%3D%22%23039%22%20d%3D%22m232.636%2C202.406v0.005c0%2C2.2119%2C0.84927%2C4.2272%2C2.2118%2C5.6894%2C1.3652%2C1.4667%2C3.2454%2C2.3777%2C5.302%2C2.3777%2C2.0672%2C0%2C3.9439-0.90487%2C5.3029-2.3654%2C1.3581-1.4587%2C2.2021-3.47219%2C2.2021-5.693v-10.768l-14.992-0.0123-0.0273%2C10.766%22%2F%3E%0A%3Ccircle%20cx%3D%22236.074%22%20cy%3D%22195.735%22%20r%3D%221.486%22%2F%3E%0A%3Ccircle%20cx%3D%22244.392%22%20cy%3D%22195.742%22%20r%3D%221.486%22%2F%3E%0A%3Ccircle%20cx%3D%22240.225%22%20cy%3D%22199.735%22%20r%3D%221.486%22%2F%3E%0A%3Ccircle%20cx%3D%22236.074%22%20cy%3D%22203.916%22%20r%3D%221.486%22%2F%3E%0A%3Ccircle%20cx%3D%22244.383%22%20cy%3D%22203.905%22%20r%3D%221.486%22%2F%3E%0A%3C%2Fg%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23quina%22%20y%3D%22-26.016%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23quina%22%20x%3D%22-20.799%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23quina%22%20x%3D%2220.745%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23quina%22%20y%3D%2225.784%22%2F%3E%0A%3C%2Fg%3E%0A%3C%2Fsvg%3E)
%22%2F%3E%0A%3C%2Fdefs%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22scale(3)%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22translate(5%2C-3)%20rotate(-120.963756)%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22translate(7%2C-1)%20rotate(-98.130102)%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22translate(7%2C2)%20rotate(-74.054604)%22%2F%3E%0A%3Cuse%20xlink%3Ahref%3D%22%23s%22%20transform%3D%22translate(5%2C4)%20rotate(-51.3401917)%22%2F%3E%0A%3C%2Fsvg%3E%0A)
%22%2F%3E%0A%20%20%20%3Cuse%20xlink%3Ahref%3D%22%23four_rays%22%20transform%3D%22rotate(60)%22%2F%3E%0A%20%20%20%3Ccircle%20r%3D%2217%22%20fill%3D%22%23000095%22%2F%3E%0A%20%20%20%3Ccircle%20r%3D%2215%22%20fill%3D%22%23fff%22%2F%3E%0A%3C%2Fsvg%3E)
Les plugins de langue fournissent des traductions pour l'interface principale de TiddlyWiki.
Les langues ci-dessous sont disponibles :
- Chinois (simplifié)
- Chinois (traditionnel)
- Français (France)
- Allemand (Autriche)
- Castellano (España)
- Allemand (Allemagne)
- 한국어 (대한민국)
Vous pouvez contribuer en suivant les instructions pour traduire TiddlyWiki dans votre langue.
| purpose | select the last N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | the last N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]last[]]
[list[Days of the Week]last[5]]
[tag[Concepts]!sort[title]last[3]]
Les informations, articles, ressources et exemples les plus récents.
Code styles and auto format settings for IDEs
https://gitlab.com/bimlas/tw5-code-style-auto-format
Posted il y a 2 mois
Implementation of TiddlyWiki Coding Style Guidelines for different IDEs.
"TiddlyWiki Toolmap" by David Gifford
https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM
Posted il y a 3 mois
A topical index of known plugins, tutorials, themes, and other helpful tools for TiddlyWiki.
https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM
Some of the topics indexed so far include:
- Background images and background colors
- Breadcrumbs
- Business - examples
- CSS / Styles, general
- Calendars, dates and timelines
- Checklists
- Collaboration
- Color palettes
- Colors
- Data visualizations
- Developer / advanced tools
- Diplay tiddlers horizontally
- Dropdowns
- Educational
- External files
- Fields
- Fonts
- Fun and games
- Home and lifestyle
- IFrames and embedding media
- Image galleries, modals and lightboxes
- Images, icons, emojis
- Importing and exporting between TiddlyWiki files
- Includes scaffolding within a tiddler, dragging to reorder tiddlers, choosing the number of columns
- Interfacing with, importing and exporting to and from other formats
- Knowledge bases, dictionaries and glossaries
- Layout/UI
- Lightboxes
- Links, linking
- Lists and filters
- Maps and geography
- Masonry, scaffolding
- Math
- MindMapping
- Mobile tools
- Music and sound
- Navigation
- node.js
- Note-taking
- Open the "filter" tab
- Partially hidden tiddlers
- Personal websites (examples)
- Presentations and slideshows
- Printing
- Project management
- Publishing and hosting TiddlyWikis on the web
- Searching tools
- Security and backup tools
- Social media, sharing, comments
- Spreadsheets and math
- Startup
- Sticky titles
- Story and screenplay creation
- Table of contents
- Tables, charts and graphs (cf data visualizations)
- Tabs
- Tags, tagging
- Task management and productivity - to do lists
- Themes
- Understanding TiddlyWiki
- Writing and editing
Timimi
https://github.com/ibnishak/Timimi
Posted il y a 3 mois
Timimi is a Web Extension and executable for Firefox, Chrome and Chromium that allows it to save standalone TiddlyWiki files.
https://github.com/ibnishak/Timimi
This is an addon using native messaging, essentially handing over the contents to a webextension host (executable) which does the actual saving. Once installed, you can save the standalone TW from anywhere in your hard drive without any more interactions, like the original Tiddlyfox addon.
TW5-SingleExecutable by Jed Carty
https://github.com/OokTech/TW5-SingleExecutable
Posted il y a 10 mois
TiddlyWiki5 Packaged with the multi-user plugin in a single executable file.
https://github.com/OokTech/TW5-SingleExecutable
Tiddlywiki, node js, multiuser plugin - all packaged into a single file so user can just download the file and run it and not have to install anything else. Versions available for windows, osx, and linux.
Widdly by Opennota
https://github.com/opennota/widdly
Posted il y a 10 mois
A cross platform server application that can save tiddlers to a local database
https://github.com/opennota/widdly
a minimal self-hosted app, written in Go, that can serve as a backend for a personal TiddlyWiki.
"Dynamic Tables" by Jed Carty
http://ooktech.com/jed/ExampleWikis/DynamicTables/
Posted il y a 10 mois
Dynamic Tables is a set of macros that allow you to create tables where the rows are created from tiddlers and the columns from the tiddler fields, or where the columns are created from tiddlers and the rows from their fields. Individual cells can be edited on the fly. Row tables can be sorted by columns and column tables can be sorted by rows.
"ATWiki" by Lamusia Project
https://lamusia.github.io/#ATWiki
Posted il y a 13 mois
A desktop application for TiddlyWiki, running on Windows.
https://lamusia.github.io/#ATWiki
TiddlyWiki for Windows. A unique non-linear notebook for capturing, organising and sharing complex information.
"muritest" by Simon Huber
http://muritest.tiddlyspot.com
Posted il y a 13 mois
A terrific demo of drag and drop, pan and zoom, and other sophisticated touch effects. Based on the muuri plugin by Uwe Stuehler.
En septembre 2004, j'ai donc publié une version préliminaire de TiddlyWiki. Il s'agissait de la plus petite application possible démontrant le concept : un simple fichier HTML de 48KB qui s'auto-engendrait.
L'inconvénient d'avoir écrit de cette manière la première version de TiddlyWiki, c'est que ça la rendait complètement impraticable pour l'édition — quand vous cliquiez sur « enregistrer les modifications », elle faisait apparaître une fenêtre montrant les données qui auraient été enregistrées s'il avait été possible d'écrire sur le système de fichiers depuis une page HTML.
Un grande partie des premiers commentaires sur TiddlyWiki étaient que c'était un outil sympathique, mais qu'il aurait été plus utile si on avait pu enregistrer correctement les modifications. J'étais plutôt frustré, car je tenais pour certaine l'impossibilité pour un fichier HTML tournant dans un navigateur d'enregistrer des modifications sur le système de fichiers local.
Quelques mois plus tard, j'ai repéré une extension Firefox expérimentale qui permettait à TiddlyWiki de sauvegarder les modifications depuis le navigateur. En examinant le code, je réalisai que l'API utilisée pour écrire sur le système de fichiers était en fait disponible pour les fichiers HTML ordinaires — pourvu qu'ils soient chargés depuis une URI de type file://.
J'adaptai le code Firefox dans le noyau de TiddlyWiki et j'ajoutai bientôt une fonctionnalité similaire pour Internet Explorer (en utilisant un ancien contrôle ActiveX que Microsoft distribuait avec Internet Explorer).
Habituellement, avec TiddlyWiki, le contenu complet de tous les tiddlers est intégré dans le fichier HTML principal. Le LazyLoading (chargement différé) fait référence à une technique qui intègre seulement les métadonnées dans le tiddler (en d'autres termes, tous les champs hormis le champ text), et demande le contenu au serveur quand il est requis.
Le Lazy Loading peut être utilisée dans deux configurations:
- À l'exécution de TiddlyWiki sous Node.js, les tiddlers images peuvent être soumis au Chargement Allégé
- À l'exécution de TiddlyWiki au Ciel pour TiddlyWeb, tous les tiddlers sont soumis au Chargement Allégé
Voir le LazyLoadingMechanism pour plus de détails sur la façon dont le LazyLoading est implémentée.
Le LazyLoading sous Node.js
Pour exécuter le chargement différé des images par TiddlyWiki, lancer le serveur par cette ServerCommand :
tiddlywiki --server 8080 $:/core/save/lazy-imagesLe LazyLoading sous TiddlyWeb
Dans la configuration actuelle, le LazyLoading est activée par défaut.
A mapping plugin based on Leaflet library. Allows you to create maps based upon geographical data contained in tiddlers.
http://sycom.github.io/TiddlyWiki-Plugins/#Leaflet%20plugin
The leaflet plugin is a (working) attempt to integrate the leaflet library in TiddlyWiki in order to display geographical purpose tiddlers.
For now
<$leafmap>widget displays an interactive map. Select size, location and zoom, clustering distance, and background. You can display data : geojson, point(s), polygon(s) and/or polyline(s) directly or calling GeoTiddler(s). Tiddler can be called individually, by list or with a filter.Have a look at demo page on the web.
En savoir plus sur l'utilisation de TiddlyWiki :
- Videos
- Partager un TiddlyWiki avec Dropbox
- Partager vos tiddlers avec d'autres
- Copier des tiddlers entre fichiers TiddlyWiki
- Créer des déroulés imbriqués
- Edition des tiddlers avec Emacs
- Tracer un texte incurvé avec SVG
- Exemple de gestion de tâches
- Ajouter un bouton suivre sur twitter
- Philosophie des tiddlers
- Adoptez une politique pour vos titres
- Exemple de galerie d'images
- TaskManagementExample (Draggable)
- TaskManagementExampleDraggableTemplate
- Introduction à la rédaction d'un filtre
- Concatenating text and variables using macro substitution
- Editing Tiddlers with Vim
- Formatting List Results as Tables with CSS - Specified Columns Methods
- Formatting List Results as Tables with CSS - Variable Column Method
- Formatting List Results as Tables (no CSS)
- Ajouter une bannière d'appel aux contributions GitHub
- Des styles personnalisés selon les tags
- How to change the sort order of sub-branches in a TOC macro
- How to create keyboard shortcuts
- How to Customize TiddlyDesktop
- How to embed PDF and other documents
- How to export tiddlers
- How to hide the author's and other fields with CSS
- Une bannière avec la date de la dernière modification
- How to widen tiddlers (aka storyriver)
- Un nouvel onglet dans le menu latéral
- How to turn off camel case linking
- Simple ways to write protect tiddlers
- Introduction to Lists
- Introduction à la rédaction d'un filtre
Fin 2011, j'ai progressivement senti que j'aurais plus de latitude hors de l'enceinte de British Telecom pour réaliser le potentiel de TiddlyWiki. D'un commun accord, je suis parti et j'ai commencé à travailler comme développeur indépendant, en me concentrant principalement sur une réincarnation de TiddlyWiki, qui pris la forme de TiddlyWiki5.
TiddlyWiki is published under a permissive BSD 3-Clause License stored in the shadow tiddler $:/core/copyright.txt:
TiddlyWiki created by Jeremy Ruston, (jeremy [at] jermolene [dot] com)
Copyright (c) 2004-2007, Jeremy Ruston
Copyright (c) 2007-2018, UnaMesa Association
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:
* Redistributions of source code must retain the above copyright notice, this
list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright notice,
this list of conditions and the following disclaimer in the documentation
and/or other materials provided with the distribution.
* Neither the name of the copyright holder nor the names of its
contributors may be used to endorse or promote products derived from
this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS'
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.In layman's terms, the license says that you can take TiddlyWiki and do anything you want with it without any license fee payment or other legal obligation to the creators of TiddlyWiki or anyone else. The quid pro quo is that there is no warranty or guarantee with open source projects like TiddlyWiki. You can't sue the contributors to TiddlyWiki for any loss or damage due to the use of TiddlyWiki: even if your data is lost due to a tragic chain of circumstances that involves TiddlyWiki.
You are respectfully requested that to make an attribution to the project, but there's no obligation to do so.
For the avoidance of doubt, any information that you choose to store within your own copy of TiddlyWiki remains yours; using TiddlyWiki to publish content doesn't change whatever rights you may have to that content.
| purpose | select the first or last N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 0 |
| output | the first N input titles |
! output | the last N input titles |
limit[N] and !limit[N] are synonyms for first[N] and last[N] respectively.
[sort[modified]!limit[20]]
[has[created]sort[created]limit[10]]
The lingo macro relates to the translation of TiddlyWiki's user interface into other languages. It returns a piece of text in the user's currently selected language.
Translatable text is supplied by language plugins containing tiddlers with specific titles that start with $:/language/.
Parameters
- title
- The title of the shadow tiddler that contains the text. The prefix
$:/language/is added automatically
This example shows the text used as the basis for the title of a newly created tiddler:
<<lingo DefaultNewTiddlerTitle>>This example shows the name of the eighth month of the year, for use in formatting dates:
<<lingo Date/Long/Month/8>>Introduction
The link catcher widget traps WidgetMessage: tm-navigate dispatched within its child content by performing any or all of these actions:
- sending a different widget message
- setting a tiddler to the title of the navigated tiddler
- setting a tiddler to a specified value
- performing a series of ActionWidgets
Content and Attributes
The content of the <$linkcatcher> widget is displayed normally.
| Attribute | Description |
|---|---|
| to | Optional title of the tiddler to be set to the title of the navigated tiddler |
| message | Optional identifier for a widget message to be sent when a navigation is caught |
| set | Optional title of the tiddler to be set to a specified value when navigation occurs |
| setTo | Value to be assigned by the set attribute |
| actions | Actions to be performed when a link is caught. Within the action string, the variable "navigateTo" contains the title of the tiddler being navigated |
L'une des aptitudes-clé de WikiText est sa capacité à créer des liens vers d'autres mémos (appelés tiddlers) ou vers des sites externes. Il existe plusieurs moyens de les mettre en oeuvre :
- Lien vers un tiddler via le titre :
[[Titre du Tiddler]] - Lien vers un tiddler avec libellé :
[[Texte à afficher|Titre du Tiddler]] - Pour les tiddlers conformes aux règles CamelCase, saisir leur titre génère automatiquement la création du lien
- Pour un lien vers un site externe, saisir l'URL complète du site :
https://tiddlywiki.com/ou[[TW5|https://tiddlywiki.com/]]
Vous pouvez annuler la prise en compte du lien en le préfixant du signe ~.
Par exemple :
* ~SalueATous suit la règle CamelCase, mais n'est pas considéré comme un lien
* ~http://google.com/ n'est pas un lien automatique non plusAffichera ceci :
- SalueATous suit la règle CamelCase, mais n'est pas considéré comme un lien
- http://google.com/ n'est pas un lien automatique non plus
... Génération du HTML :
<ul><li>SalueATous suit la règle <a class="tc-tiddlylink tc-tiddlylink-resolves" href="#CamelCase">CamelCase</a>, mais n'est pas considéré comme un lien</li><li>http://google.com/ n'est pas un lien automatique non plus</li></ul>
Pour que cette syntaxe fonctionne, l'adresse URL doit être reconnue comme une URL, donc débuter par un protocole comme http:// ou file://. Mais, vous pouvez forcer le lien externe sans cela en utilisant cette syntaxe :
[ext[tiddlywiki.com]]
[ext[libellé à afficher|tiddlywiki.com]]
[ext[Faire un Don|bitcoin:1aabbdd....?amount=0.001]]Personnaliser les Liens des Tiddlers
Voir le LinkWidget pour plus de détail sur le widget sous-jacent utilisé pour implémenter les liens des tiddlers, et notamment les macros qui peuvent être utilisées pour personnaliser leur comportements.
Personnaliser les Liens des Tiddlers
Voir le LinkWidget pour plus de détail sur le widget sous-jacent utilisé pour implémenter les liens des tiddlers, et notamment les macros qui peuvent être utilisées pour personnaliser leur comportements.
| purpose | find the titles linked to by each input title |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | the titles to which the input tiddlers contain hard links |
Each input title is processed in turn. The corresponding tiddler's list of links is generated, in the order in which they appear in the tiddler's text, and dominantly appended to the operator's overall output.
[[HelloThere]links[]]
Here are some hard links:
The link widget generates links to tiddlers. (Use the HTML <a> element to generate external links).
Content and Attributes
| Attribute | Description |
|---|---|
| to | The title of the target tiddler for the link (defaults to the current tiddler) |
| aria-label | Optional accessibility label |
| tooltip | Optional tooltip WikiText |
| tabindex | Optional numeric tabindex |
| draggable | "yes" to enable the link to be draggable (defaults to "yes") |
| tag | Optional tag to override the default "a" element |
| class | Optional CSS classes in addition to the default classes (see below) |
| overrideClass | New in: 5.1.16 Optional CSS classes instead of the default classes |
The content of the link widget is rendered within the <a> tag. The draggable functionality is equivalent to using the DraggableWidget with the tiddler attribute set to the link target.
The default value of the tooltip attribute is supplied by the tv-wikilink-tooltip variable.
This means that you can control the text of a link tooltip in several ways:
<$link to="HelloThere" tooltip="Custom tooltip">Link 1</$link>
<$set name="tv-wikilink-tooltip" value="I'm a link to {{!!title}}">
<$link to="HelloThere">Link 2</$link>
</$set>
Renders as:
Note that the tooltip is rendered with the current tiddler set to the target of the link.
A useful convention is to set the tooltip like this:
\define tv-wikilink-tooltip()
<$transclude field="tooltip"><$transclude field="title"/></$transclude>
\endThis causes the tooltip to be the tooltip field of the target tiddler. If the field isn't present, then the title is used instead.
CSS Classes
The link widget automatically determines and applies the following classes to links:
tc-tiddlylink- applied to all linkstc-tiddlylink-external- applied to external, non-tiddler linkstc-tiddlylink-internal- applied to tiddler linkstc-tiddlylink-missing- applied to tiddler links where the target tiddler doesn't existtc-tiddlylink-resolves- applied to tiddler links when the target tiddler does exist
Use the class attribute to specify additional css classes, or overrideClass to apply only that but not the above defaults, e.g. when used in a LinkCatcherWidget:
*<$link class="example">Here</$link> the `example` class is added.
*<$link overrideClass="example">Here</$link> only the `example` class applies.
*<$link overrideClass="">Here</$link> no class is set.Affichera ceci :
href generation
The following process is used to generate the href attribute of the generated HTML <a> element:
- If
tv-get-export-linkis defined it is invoked to convert the target tiddler title to thehrefvalue- In practice, only a JavaScript macro can be used
- New in: 5.1.15 If
tv-filter-export-linkis defined it is interpreted as a filter that converts the target tiddler title to thehrefvalue - If
tv-wikilink-templateis defined it is treated as a specialised macro body that can perform limited conversion of the target tiddler title to thehrefvalue - Otherwise, the target tiddler title is URI encoded to create the
href
Configuration variables
| purpose | select titles via a list field |
|---|---|
| input | ignored |
! input | a selection of titles |
| parameter | R = a reference to a field or property of a particular tiddler |
| output | the titles stored as a title list at R |
! output | those input titles that are not mentioned at R |
R can reference either a field or a property. See TextReference for the syntax.
- If neither is specified, the
listfield is used by default. So[list[T]]outputs the titles listed in thelistof tiddler T. - If
Rconsists of only a field or a property, the tiddler part of the reference defaults to the current tiddler. So[list[!!tags]]outputs the titles listed in thetagsfield of the current tiddler.
These examples make use of the Days of the Week tiddler.
[list[HelloThere]]
[list[Days of the Week!!short]]
La macro macro list-links renvoie une liste formatée de liens vers une sélection de tiddlers.
Si un tiddler a un champ caption, il est affiché au lieu du titre du tiddler.
Paramètres
Cet exemple liste tous les tiddlers dont les titres commencent par J :
<<list-links filter:"[prefix[J]]">>Cet exemple liste la documentation des tiddlers des macros du noyau, chacune ayant un champ caption :
<<list-links filter:"[tag[Core Macros]]">>The list-links-draggable macro renders the ListField of a tiddler as a list of links that can be reordered via drag and drop.
Parameters
- tiddler
- The title of the tiddler containing the list
- field
- The name of the field containing the list (defaults to
list) - type
- The element tag to use for the list wrapper (defaults to
ul) - subtype
- The element tag to use for the list items (defaults to
li) - class
- Optional space separated classes to add to the wrapper element
- itemTemplate
- Optional title of a tiddler to use as the template for rendering list items
If the itemTemplate parameter is not provided then the list items are rendered as simple links. Within the itemTemplate, the currentTiddler Variable refers to the current list item.
The list-tagged-draggable macro renders the tiddlers with a particular tag as a list of links that can be reordered via drag and drop.
Parameters
- tag
- The title of the tag
- subFilter
- An optional subfilter to filter out unwanted items (eg
!tag[done]) - itemTemplate
- Optional title of a tiddler to use as the template for rendering list items
- emptyMessage
- Optional wikitext to display if there are no tiddlers with the specified tag
Note that the ordering is accomplished by assigning a new list to the list field of the tag tiddler. Any list-before or list-after fields on any of the other tiddlers carrying the tag are also removed to ensure the list field is respected.
If the itemTemplate parameter is not provided then the list items are rendered as simple links. Within the itemTemplate, the currentTiddler Variable refers to the current list item.
| purpose | find the titles that list the input titles |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to list |
| output | the titles in which field F mentions any of the input titles |
F is assumed to be a title list.
Each input title is processed in turn. A list of tiddlers whose F field mentions it is generated (in no particular order) and dominantly appended to the operator's overall output.
New in: 5.1.18 See WebServer for details of TiddlyWiki's web server functionality.
Serves a wiki over HTTP.
The listen command uses NamedCommandParameters:
--listen [<name>=<value>]...All parameters are optional with safe defaults, and can be specified in any order. The recognised parameters are:
- host - optional hostname to serve from (defaults to "127.0.0.1" aka "localhost")
- path-prefix - optional prefix for paths
- port - port number on which to listen; non-numeric values are interpreted as a system environment variable from which the port number is extracted (defaults to "8080")
- credentials - pathname of credentials CSV file (relative to wiki folder)
- anon-username - the username for signing edits for anonymous users
- username - optional username for basic authentication
- password - optional password for basic authentication
- authenticated-user-header - optional name of header to be used for trusted authentication
- readers - comma separated list of principals allowed to read from this wiki
- writers - comma separated list of principals allowed to write to this wiki
- csrf-disable - set to "yes" to disable CSRF checks (defaults to "no")
- root-tiddler - the tiddler to serve at the root (defaults to "$:/core/save/all")
- root-render-type - the content type to which the root tiddler should be rendered (defaults to "text/plain")
- root-serve-type - the content type with which the root tiddler should be served (defaults to "text/html")
- tls-cert - pathname of TLS certificate file (relative to wiki folder)
- tls-key - pathname of TLS key file (relative to wiki folder)
- debug-level - optional debug level; set to "debug" to view request details (defaults to "none")
- gzip - set to "yes" to enable gzip compression for some http endpoints (defaults to "no")
For information on opening up your instance to the entire local network, and possible security concerns, see the WebServer tiddler at TiddlyWiki.com.
Champ de tiddler, list peut aider à structurer son contenu. Sa valeur est une liste de titres, et peut être maniée de différentes façons :
- Le champ
listd'un tiddler utilisé comme étiquette détermine l'ordre des tiddlers portant ce tag - voir Étiqueter pour plus de détails - Le filtre
listsélectionne les entrées d'une liste - Le filtre
listedsélectionne les tiddlers listant le(s) tiddler(s) sélectionné(s) - Le NavigatorWidget manipule un tiddler $:/StoryList contenant un champ
listdes tiddlers affichés dans la colonne principale Récents
Listes non-ordonnées
Vous pouvez créer des listes non ordonnées en préfixant du caractère * :
* Premier élément d'une liste
* Deuxième éléments d'un liste
** Un sous-élément
* Troisième élément d'une liste
Affichera ceci :
- Premier élément d'une liste
- Deuxième éléments d'un liste
- Un sous-élément
- Troisième élément d'une liste
... Génération du HTML :
<ul><li>Premier élément d'une liste</li><li>Deuxième éléments d'un liste<ul><li>Un sous-élément</li></ul></li><li>Troisième élément d'une liste</li></ul>
Listes ordonnées
Les listes ordonnées utilisent # au lieu de *:
# Premier élément
# Deuxième élément
# Troisième élément
Affichera ceci :
- Premier élément
- Deuxième élément
- Troisième élément
... Génération du HTML :
<ol><li>Premier élément</li><li>Deuxième élément</li><li>Troisième élément</li></ol>
Vous pouvez combiner des listes non-ordonnées et des listes ordonnées :
* À faire ce jour
*# Manger
* Chercher qlq chose à faire
*# Ceci
*# Cela
*## Et le reste
Affichera ceci :
- À faire ce jour
- Manger
- Chercher qlq chose à faire
- Ceci
- Cela
- Et le reste
... Génération du HTML :
<ul><li>À faire ce jour<ol><li>Manger</li></ol></li><li>Chercher qlq chose à faire<ol><li>Ceci</li><li>Cela<ol><li>Et le reste</li></ol></li></ol></li></ul>
L'exemple inverse, avec les nombres en premier niveau :
# À faire ce jour
#* Manger
# Chercher qlq chose à faire
#* Ceci
#* Cela
#** Et le reste
Affichera ceci :
- À faire ce jour
- Manger
- Chercher qlq chose à faire
- Ceci
- Cela
- Et le reste
... Génération du HTML :
<ol><li>À faire ce jour<ul><li>Manger</li></ul></li><li>Chercher qlq chose à faire<ul><li>Ceci</li><li>Cela<ul><li>Et le reste</li></ul></li></ul></li></ol>
Les classes CSS
Vous pouvez affecter une classe CSS à un des membres de la liste en procédant ainsi :
* Liste Un
*.MyClass Liste Deux
* Liste Trois
Affichera ceci :
- Liste Un
- Liste Deux
- Liste Trois
... Génération du HTML :
<ul><li>Liste Un</li><li class="MyClass">Liste Deux</li><li>Liste Trois</li></ul>
Combiner listes et blocs
Noter que les blocs avec WikiText peuvent être mixés aux listes. Par exemple :
* Liste Une
** Liste deux
**> Un bloc
**> Un autre bloc
* Liste trois
Affichera ceci :
- Liste Une
- Liste deux
Un bloc
Un autre bloc
- Liste deux
- Liste trois
... Génération du HTML :
<ul><li>Liste Une <ul><li>Liste deux<blockquote><p>Un bloc</p><p>Un autre bloc</p></blockquote></li></ul></li><li>Liste trois</li></ul>
Les paragraphes dans les listes
Les entrées d'une liste sont séparées par des sauts de ligne, rendant impossible d'y inclure des sauts de lignes, sans passer à l'entrée suivante. Il y a deux façons de passer outre.
En un, vous pouvez transclure dans le paragraphe le contenu d'un autre tiddler. Par exemple :
* Première entrée
* <$transclude tiddler="MonTiddler" mode="block"/>
* TroisièmeEn deux, vous pouvez utiliser le tag HTML "div" pour inclure un contenu multiligne. Par exemple :
# Étape 1
# Étape 2
# Étape 3<div>
Ici, le premier parmi plusieurs paragraphes. Noter que le double saut de ligne précédant ce paragraphe est pris en compte.
Et ici, le deuxième parmi plusieurs paragraphes.
</div>
# Étape 4
# Étape 5
# Étape 6Le widget ListWidget affiche la suite de tiddlers qui correspondent au tiddler filtre. Il répond à de nombreux cas d'utilisation :
- Affichage de listes personnalisées de liens, comme le menu latéral de TiddlyWiki5
- Listes personnalisées, comme "tous les tiddlers étiquetés 'task' et non-étiquetés 'fait'"
- Lister chacun des tags appliqués au tiddler
- Manipuler le déroulé principal
Les tiddlers sont affichés en transcluant chacun tour à tour via un gabarit. Il existe plusieurs façons de spécifier le gabarit et de contrôler le comportement de la liste.
Exemples
Liste brute
<$list filter="[tag[ListWidget]sort[title]]"/>Affichera :
Sorties personnalisées
<$list filter="[tag[ListWidget]sort[title]]">
<<currentTiddler>>
{{||$:/core/ui/ViewTemplate/tags}}
</$list>Affichera :
Gabarit personnalisé
<$list filter="[tag[ListWidget]sort[title]]" template="$:/core/ui/ViewTemplate/subtitle"/>Affichera :
Listes Groupées
Se reporter à Listes imbriquées pour voir comment générer des listes groupées et imbriquées en utilisant le widget list.
Contenu et Attributs
Le contenu du widget <$list> est un gabarit optionnel à utiliser pour l'affichage de chaque tiddler de la liste. Autrement, le gabarit peut être spécifié comme titre du tiddler dans le gabarit attribut. En l'absence de directive, le gabarit par défaut affiche juste le titre du tiddler.
| Attribut | Description |
|---|---|
| filter | Le filtre du tiddler à afficher |
| template | Le titre du tiddler gabarit pour transclure chaque tiddler de la liste. Si aucun gabarit n'est spécifié, Le corps du widget list sert de gabarit. En l'absence de corps, un simple lien vers le tiddler est renvoyé. |
| editTemplate | Un gabarit différent pour la modification des Ébauches de Tiddlers en mode édition |
| variable | Le nom d'une variable dans laquelle le titre de chaque tiddler listé est mémorisé. Par défaut currentTiddler |
| emptyMessage | Message à afficher quand la liste est vide |
| storyview | Nom optionnel du module responsable de l'animation/traitement de la liste |
| history | Le titre du tiddler contenant l'historique de navigation |
Mode édition
Le widget <$list> peut afficher de façon optionnelle les tiddlers ébauche via un gabarit différent lors de l'édition, voir Mécanisme d'Ébauche.
attribut storyview
L'attribut optionnel storyview indique le nom du module qui anime les changements dans la liste (incluant la navigation). Le noyau intègre les animations (storyview) suivantes :
classic: affiche la liste comme une séquence ordonnée de tiddlerszoomin: affiche juste le tiddler courant dans la liste, avec une animation zoom à la navigation entre les tiddlerspop: rétrécit les éléments sur place
Afin que les storyviews s'animent correctement, chaque entrée de la liste doit être un élément du DOM en mode bloc unique.
Historique et navigation
L'attribut optionnel history indique le nom du tiddler utilisé pour tracer le tiddler en cours pour les besoins de la navigation. Quand le tiddler history change, l'affichage de la liste répond en demandant à listview de diriger la navigation jusqu'au nouveau tiddler. Voir Mécanisme Historique pour les détails.
Charge des tiddlers à partir de fichiers TiddlyWikiClassic 2.x.x (.html), .tiddler, .tid, .json ou d'autres types de fichiers.
--load <chemindufichier>Pour charger des tiddlers à partir d'un fichier TiddlyWiki chiffré, vous devrez d'abord spécifier le mot de passe à l'aide de la commande password. Par exemple :
tiddlywiki ./MonWiki --password pa55w0rd --load mon_wiki_secret.htmlÀ noter que Tiddlywiki refusera de charger une version plus ancienne d'un plugin déjà chargé.
| purpose | applies a prefix to each input title to yield the title of a tiddler from which the final value is retrieved |
|---|---|
| input | a selection of titles |
| suffix | D = the default value to be used for missing lookups |
| parameter | P = prefix applied to input titles to yield title of lookup tiddler from which value is retrieved |
| output | the lookup values corresponding to each input title |
New in: 5.1.15
The action of this operator is as follows:
- Apply the specified prefix to each input tiddler title, yielding a new list of tiddler titles
- Transclude the value of each of those tiddlers
- Substitute the default value for missing or empty tiddlers
- Return the list of values
[all[shadows+tiddlers]tag[$:/tags/PageControls]lookup[$:/config/PageControlButtons/Visibility/]]
[all[shadows+tiddlers]tag[$:/tags/PageControls]lookup:show[$:/config/PageControlButtons/Visibility/]]
- What follows is a formal presentation of the syntax of the WikiText syntax for macro calls, using railroad diagrams. A simpler overview is also available.
espace denotes a sequence of whitespace characters.
The macro's name is a sequence of non-whitespace characters autre que ( or >.
Each individual param-value has the following syntax:
The param-nom is a sequence of letters (A–Z, a–z), digits (0–9), hyphens (-) and underscores (_).
The valeur is specified as follows :
Pour appeler une macro, placez des <<parenthèses en double équerres>> autour de son nom et des valeurs de ses paramètres. ex : <<macro val1 val2 ... valn>>
Par défaut, les paramètres sont passés dans l'ordre fixé lors de la définition de la macro. Un paramètre peut être identifié par son nom, pour plus de clarté ou pour pouvoir en modifier l'ordre.
Si aucune valeur n'est passée en paramètre, la valeur fixée lors de la définition de la macro est assignée. (Si aucune valeur n'est définie par défaut, le paramètre est tout simplement vide.)
Chaque valeur de paramètre peut être passée par des 'cotes unique', des "double cotes", des """double cotes triplés""" ou des [[doubles crochets]]. Les double cotes triplés permettent de passer à peu près toutes les valeurs. Si une valeur ne contient ni espace, ni simple ou double cotes, les délimiteurs sont inutiles.
Une description description plus formelle de cette syntaxe est aussi disponible.
La syntaxe courante est une forme abrégée du widget $macrocall. Ce widget permet, par lui-même, une plus grande flexibilité, incluant la capacité de transclure des valeurs en paramètres ou de les générer via des macros additionnelles .
Comme les macros sont de simples variables paramétrées, des valeurs de variables peuvent être intègrées en faisant appel aux mêmes techniques.
\define sayhi(name:"Bugs Bunny" address:"Rabbit Hole Hill")
Salut, Je suis $name$ et je vis à $address$.
\end
<<sayhi>><<sayhi Bugs>><<sayhi "Donald Duck" Disneyland>><<sayhi "Mickey Mouse" "Mouse House">><<sayhi name:'Minnie Mouse' address:[[Mouse House]]>><<sayhi address:"Quacky Towers" name:"Donald Duck">><<sayhi "Mickey Mouse" """"Mouse House",
Rodent's Lane,
Squeaksville,
Ratland""">>- Ce qui suit est la description formelle de la syntaxe du pragma
\define, par des diagrammes en chemin de fer. Une présentation simplifiée est aussi disponible.
espace représente une série d'espaces vierges.
Le nom de macro est une série de caractères sans espace, autres que ( ou >.
La liste de déclaration de paramètre (parametres) a la syntaxe suivante :
Le séparateur de paramètres (sep) est toute série de caractères différente d'un nom de paramètre (parametre.nom). Entre autre chose, cela comprend les virgules, les espaces et les sautsdeligne.
Un parametre.nom est une suite de lettres (A–Z, a–z), de chiffres (0–9), de tirets (-) de soulignés (_).
Chaque parametre a, respectivement, la syntaxe suivante :
La valeur par défaut d'un paramètre est spécifiée comme suit :
La définition de la suite se fait comme suit :
Si marque un saut de ligne.
Un code.extrait correspond à toute suite de caractère qui ne termine pas la définition de la macro. Ce qui veut dire qu'un extrait de code, s'il comporte une ligne unique, ne peut comporter de sautdeligne ou s'il occupe plusieurs lignes ne peut comporter de \end.
L'extrait de code peut contenir des ZoneRéservée en utilisant la syntaxe suivante:
Une macro est définie par l'utilisation du pragma \define. Comme tout pragma, il peut seulement prendre place au début d'un tiddler.
La première ligne de la définition indique le nom de la macro suivi de ses paramètres. Chaque paramètre a un nom, et de façon optionnelle une valeur par défaut utilisée si aucune valeur n'est passée lors de l'appel de la macro. Les lignes qui suivent contiennent le texte de la macro (càd l'extrait de code représenté par le nom de la macro), jusqu'à l'apparition du \end :
\define sayhi(name:"Bugs Bunny" address:"Rabbit Hole Hill")
Salut, Je suis $name$ et je vis à $address$.
\end
Vous pouvez éviter l'utilisation du marqueur final \end, en rédigeant toute la définition sur une seule ligne :
\define sayhi(name:"Bugs Bunny") Salut, Je suis $name$.Une présentation plus formelle de cette syntaxe est aussi disponible.
ZoneRéservée
Les extraits de code peuvent utiliser des Zones Réservées en paramètres. Il suffira de placer le nom du paramètre entre les signes dollar, comme $ceci$.
Il est aussi possible d'utiliser des Zones Réservées comme variables. Il suffira de placer le nom de la variable (ou du nom de la macro) entre les signes dollar entourés de parenthèses, comme $(ceci)$.
À la valeur actuelle du paramètre ou de la variable se substituera celle portée par le ZoneRéservée lors de l'appel de la macro :
\define say-hi-using-variables()
Salut, je suis $(name)$ et je vis à $(address)$.
\end
\define name() Bugs
<$set name="address" value="Rabbit Hole Hill">
<<say-hi-using-variables>>
</$set>Étendue
Les macros peuvent être utilisées dans le tiddler où elles sont définies, ainsi que tous les tiddlers qui le transclus.
Pour étendre l'utilisation d'une macro à tous les tiddlers, définissez-la dans un tiddler étiqueté $:/tags/Macro.
Il est aussi possible de développer une macro dans un module JavaScript. Les macros JavaScript sont disponibles dans tous les tiddlers, et offrent un maximum de flexibilité.
On peut importer dans un tiddler les définitions de macros d'une sélection d'autres tiddlers en utilisant le widget $importvariables.
Introduction
Le widget d'appel de macro propose une syntaxe alternative pour invoquer des macros. L'avantage de la forme de ce widget est de passer des paramètres de macro en attributs de widget, ce qui permet d'utiliser des indirections et d'affecter des valeurs de macro.
Par exemple, une macro appelée italicise ayant pour seul paramètre texte peut être invoquée de ces différentes façons :
<<italicise "Texte à mettre en italiques">>
<<italicise text:"Texte à mettre en italiques">>
<$macrocall $name="italicise" text="Texte à mettre en italiques"/>
<$macrocall $name="italicise" text={{Titre du tiddler contenant le Texte à mettre en italiques}}/>
<$macrocall $name="italicise" text=<<textMaker "Une autre macro pour générer du texte à italiciser">>/>Vous pouvez examiner plusieurs exemples du widget d'appel de macro dans le noyau :
- Liste les informations du module : $:/snippets/modules
- Liste les informations du champ : $:/snippets/allfields
- Génère les URIs
data:: $:/themes/tiddlywiki/starlight/styles.tid
Contenu et Attributs
Le contenu du widget <$macrocall> est ignoré.
| Attribut | Description |
|---|---|
| $name | Nom de la macro appelée |
| $type | Type de contenu par lequel le texte entrée sera analysé (par défault text/vnd.tiddlywiki) |
| $output | Type de contenu affiché en sortie (par défaut text/html, peut aussi être text/plain) |
| parameters | Paramètres de macro spécifiés comme attributs |
Les macros sont des bouts de texte qui peuvent être insérés à l'aide d'un raccourci concis :
<<maMacro>>Vous pouvez écrire vos propres macros en WikiText ou pour plus de souplesse, vous pouvez écrire des macros en Javascript.
Les macros suivantes sont fournies avec TiddlyWiki :
- changecount
- colour
- contrastcolour
- csvtiddlers
- datauri
- dumpvariables
- jsontiddlers
- lingo
- list-links
- makedatauri
- now
- qualify
- resolvepath
- Stylesheet Macros
- Macros Tables des matières
- tabs
- tag
- timeline
- version
- colour-picker
- copy-to-clipboard
- image-picker
- jsontiddler
- list-links-draggable
- list-tagged-draggable
- Syntaxe des Macro
- tag-picker
- tag-pill
- thumbnail
- tree
- now
- toc
- La macro tabs
The makedatauri macro takes a piece of text and an associated ContentType, and returns a corresponding data URI.
makedatauri is used to implement the datauri macro.
Parameters
- text
- The text to be converted to a data URI
- type
- The ContentType of the text
Construit le tiddler $:/UpgradeLibrary pour la procédure de mise à jour.
La bibliothèque de mise à jour est formatée comme un tiddler de plugin ordinaire avec le type library. Elle contient un exemplaire de chacun des packs de plugins, thèmes et languages disponibles dans le répertoire de TiddlyWiki5.
Cette commande est prévue pour un usage interne ; elle n'a d'intérêt que pour les utilisateurs qui construisent une variante de la procédure de mise à jour.
--makelibrary <titre>L'argument titre a pour valeur par défaut $:/UpgradeLibrary.
Voir le mécanisme de mise à jour pour plus de détails.
To get your own custom Journal button, start by cloning the New Journal button.
Then create your own config tiddlers, eg:
$:/config/myNewTiddler/Tagsand ...$:/config/myNewTiddler/Titleand ...$:/config/myNewTiddler/Text
Edit your custom button and "search and replace" the config tiddler names.
Change the following lines, near the end of the tiddler from
<$set name="journalTitleTemplate" value={{$:/config/NewJournal/Title}}>
<$set name="journalTags" value={{$:/config/NewJournal/Tags}}>
<$set name="journalText" value={{$:/config/NewJournal/Text}}>to
<$set name="journalTitleTemplate" value={{$:/config/myNewTiddler/Title}}>
<$set name="journalTags" value={{$:/config/myNewTiddler/Tags}}>
<$set name="journalText" value={{$:/config/myNewTiddler/Text}}>if you want to see your config tiddlers in the sidebar use:
<$set name="journalTitleTemplate" value={{config/myNewTiddler/Title}}>
<$set name="journalTags" value={{config/myNewTiddler/Tags}}>
<$set name="journalText" value={{config/myNewTiddler/Text}}>Cette démonstration montre comment utiliser SVG pour faire suivre un chemin incurvé à un texte transclu. Entrez du texte dans la zone çi-dessous pour essayer ; visualiser le code source pour voir examiner le fonctionnement.
- Create a backup of your current TiddlyWiki HTML file (just in case)
- Open your TiddlyWiki in a browser
- In another browser window, find a link to the plugin, e.g. $:/plugins/tiddlywiki/example. You will typically find these links on the home page of the plugin (for example, https://tiddlywiki.com/plugins/tiddlywiki/katex/)
- Drag the link $:/plugins/tiddlywiki/example to the browser window containing your TiddlyWiki
- Save your TiddlyWiki ()
- Refresh the page so that TiddlyWiki loads the new plugin ()
- The plugin should now be available for use
Markdown est un langage de balisage léger créé par John Gruber et Aaron Swartz en 2004. Son but est d'offrir une syntaxe facile à lire et à écrire.
Wikipedia : http://fr.wikipedia.org/wiki/Markdown
Site web officiel : http://daringfireball.net/projects/markdown/
Le plugin Markdown permet d'utiliser des tiddlers écrits avec les conventions de balisage Markdown standard.
An experimental MathJax plugin for TiddlyWiki version 5. As Martin says, the implementation is a bit of a hack but may be useful until we have a better alternative.
http://mathjax-tw5.kantorsite.net
Welcome. I have created plugin for TiddlyWiki 5 which allows you to use MathJax (math in TeX and MathML) inside TiddlyWiki 5. It's unofficial plugin and it doesn't follow general policy of TiddlyWiki as stand-alone solution but it works. So you can use it if you want.
MathML est un langage de notation pour équations mathématiques qui peut être utilisé en HTML.
Si votre navigateur le supporte, les balises MathML peuvent être manipulées par WikiText comme du HTML.
Voici un exemple d'équation MathML issue du W3C:
<math><mrow><mo>[</mo><mtable><mtr><mtd><mn>0</mn></mtd><mtd><mn>1</mn></mtd><mtd><mn>0</mn></mtd></mtr><mtr><mtd><mn>0</mn></mtd><mtd><mn>0</mn></mtd><mtd><mn>1</mn></mtd></mtr><mtr><mtd><mn>1</mn></mtd><mtd><mn>0</mn></mtd><mtd><mn>0</mn></mtd></mtr></mtable><mo>]</mo></mrow></math>Ce qui s'affiche ainsi :
Rencontres locales d'enthousiastes de TiddlyWiki tout autour du monde :
- OXTWIG, le groupe d'intérêt TiddlyWiki d'Oxford des rencontres mensuelles à Oxford, UK pour partager des expériences sur l'utilisation de TiddlyWiki
Si vous êtes un enthousiaste de TiddlyWiki veuillez réfléchir au lancement d'un TWIG local, c'est un excellent moyen de faire part au monde de l'utilisation de TiddlyWiki
Les messages Widget sont générés par les widgets en réponse aux actions utilisateur. Ils parcourent l'arbre widget jusqu'à ce qu'ils soient traités par un ascendant widget.
Les messages suivants sont implémentés dans le noyau :
- tm-add-field
- tm-add-tag
- tm-auto-save-wiki
- tm-browser-refresh
- tm-cancel-tiddler
- tm-clear-password
- tm-close-all-tiddlers
- tm-close-other-tiddlers
- tm-close-tiddler
- tm-copy-to-clipboard
- tm-delete-tiddler
- tm-download-file
- tm-edit-bitmap-operation
- tm-edit-text-operation
- tm-edit-tiddler
- tm-fold-all-tiddlers
- tm-fold-other-tiddlers
- tm-fold-tiddler
- tm-full-screen
- tm-home
- tm-import-tiddlers
- tm-load-plugin-from-library
- tm-load-plugin-library
- tm-login
- tm-logout
- tm-modal
- tm-navigate
- tm-new-tiddler
- tm-notify
- tm-open-external-window
- tm-open-window
- tm-perform-import
- tm-permalink
- tm-permaview
- tm-print
- tm-remove-field
- tm-remove-tag
- tm-save-tiddler
- tm-save-wiki
- tm-scroll
- tm-server-refresh
- tm-set-password
- tm-unfold-all-tiddlers
| purpose | filter items shorter than the specified minimum length |
|---|---|
| input | a list of items |
| parameter | minlength = the minimum length for items |
| output | those items at least as long as the specified minimum length |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]minlength[7]]
[list[Days of the Week]minlength[1]]
The Mobile Drag And Drop Shim Plugin provides a "shim" that enables HTML 5 compatible drag and drop operations on mobile browsers, including iOS and Android. The shim was created by Tim Ruffles and is published at https://github.com/timruffles/ios-html5-drag-drop-shim.
Modals (or "wizards") fade the main TiddlyWiki window to display an isolated tiddler that must be explicitly dismissed by the user.
Modals are displayed with the WidgetMessage: tm-modal.
Within the action string of the DroppableWidget, the modifier variable contains the modifier key(s) held during the drag-process. The possible keys are ctrl, shift or both ctrl and shift
The variable contains a string that identifies the keys:
| Modifier Key | Variable Content |
| ctrl | ctrl |
| shift | shift |
| ctrl+shift | ctrl-shift |
| no modifier (normal drag) | normal |
Un module dans TiddlyWiki5 est un tiddler contenant du JavaScript exécutable, de type application/javascript et dont le champ module-type correspond au ModuleType du module.
Voir dans l'onglet Info du , l'option Avancé, puis cliquer sur $Modules chargés pour les listes des modules chargés.
| purpose | select the names of all modules of the input module types |
|---|---|
| input | a selection of module types |
| parameter | none |
| output | the title of each module with any of the input types |
Le champ module-type d'un module JavaScript est une chaine identifiant le type de module. Ci-après la liste des types de module utilisés dans ce wiki :
- allfilteroperator
- Un sous-opérateur pour l'opérateur de filtre all.
- animation
- Animations pouvant être utilisées par le RevealWidget.
- authenticator
- Définit comment les requêtes sont authentifiées par le serveur HTTP intégré.
- bitmapeditoroperation
- Une opération intégrée à la barre d'outils de l'éditeur de bitmap.
- command
- Commandes qui peuvent être exécutées en mode Node.js.
- config
- Données à inclure dans
$tw.config. - filteroperator
- Méthodes d'opérateurs pour les filtres.
- global
- Données globales à inclure dans
$tw. - info
- Publie des informations système via le pseudo-plugin $:/temp/info-plugin.
- isfilteroperator
- Opérandes pour l'opérateur de filtre is.
- library
- Module générique pour les modules JavaScript de portée générale.
- macro
- Définitions de macros JavaScript.
- parser
- Parseurs pour divers types de contenu.
- route
- Définit comment chaque motif d'URL est géré par le serveur HTTP intégré.
- saver
- Les tiddlers d'enregistrement contiennent les différentes méthodes pour enregistrer des fichiers à partir du navigateur.
- startup
- Fonctions de démarrage.
- storyview
- Différents points de vue sur le déroulé, qui personnalisent l'animation et le comportement des widgets de liste.
- texteditoroperation
- Une opération intégrée à la barre d'outils de l'éditeur de texte.
- tiddlerdeserializer
- Convertit différents types de contenu en tiddlers.
- tiddlerfield
- Définit le comportement d'un champ de tiddler.
- tiddlermethod
- Ajoute des méthodes au prototype
$tw.Tiddler. - upgrader
- Applique une procédure de mise à jour aux tiddlers lors de l'opération de mise à jour/importation.
- utils
- Ajoute des méthodes dans
$tw.utils. - utils-node
- Ajoute des méthodes spécifiques à Node.js dans
$tw.utils. - widget
- Les widgets encapsulent les méthodes de rendu et de rafraichissement du DOM.
- wikimethod
- Ajoute des méthodes à
$tw.Wiki. - wikirule
- Règles d'analyse pour le parseur WikiText principal.
| purpose | select the names of all TiddlyWiki module types |
|---|---|
| input | ignored |
| parameter | none |
| output | the name of each known TiddlyWiki module type, in alphabetical order |
';. .;c'
:XNo ,kjack' .:dd
,K0X: '0l Tiddly:',..,Wiki.
jacK' .dk. '';jack .xk;
Jack; ..',','... '0c .0c
:0:c0l. .:dTidllyc::cjoWikioc:,,,,;;:cJACKc:;;d0. 'K:
l0:'jack,... ...',:lkxc. ..';:ccc:;;,'...',:loc .Kc
,xk:..,jackjackjack;'. :K,
.lxxl;.. . .Ox.
.':lTiddlyWikI. .xk.
`` ;0; . ;Od.
.dO' .0Ojackx,
cOo' .kk'.'..
.k0' .cOo.
lO; ... .jack.
.xk' .jackTiddlyWikijackO, .lkd;.
;Oo. .dO. .ok. ,Oo.
l0; .c, ,0: .kd l0.
.xk. .xNx lO. lO. ;0,
.Od. ,XW0, :0; dk. .kx.
.kx. jACKx' cOl. .Ol ;0:
.oO: .JACKx. .jack;'. .0: c0;
'dkc ,lXKd' .'jack. .Ol cOc.
.;ljack,.;xkc,...,oK, 'xxjack. .oko.
`` 'cljack' .okdlcJack.
'JacK,'
| purpose | move marker N places in the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | marker = the list item to be used as a marker |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[move[Wednesday]]
[list[Days of the Week]] +[move:-2[Wednesday]]
MultiTiddlerFiles allow multiple tiddlers to be concisely represented in a single text file.
The goals of this format are:
- To be easy to type and easy to read
- Optimised for single line strings
- To allow common fields or tags to be shared within groups of tiddlers
- To be simple to process with external tools
MultiTiddlerFiles have the extension multids. The file is structured as a block of shared fields followed by a blank line. The rest of the file is a sequence of comments and tiddlers. Tiddlers are specified by their title, followed by a colon, at least one space character, and then the rest of the line is the text field for the tiddler.
For example:
title: $:/language/ControlPanel/
tags: strings
modifier: JoeBloggs
Basics/Caption: Basics
# This is a comment
Basics/Version: ~TiddlyWiki VersionThis example defines two tiddlers, $:/language/ControlPanel/Basics/Caption and $:/language/ControlPanel/Basics/Version.
If a title field is specified in the header then it is treated as a prefix for the individual tiddlers defined in the title.
Syntax Specification
MultiTiddlerFiles
Header Line
Tiddler Descriptor Line
Comment Line
New in: 5.1.18 Most TiddlyWiki Commands use a position-based system for their parameters where each parameter must be listed in the precise order defined by the command. Some of the more complex commands offer an alternative scheme of named command parameters. For example, here we provide two parameters named "port" and "host":
--listen port=8090 host=0.0.0.0Note that the order of the parameters does not matter.
Using special characters within a parameter requires quoting. Unix, Linux and the Mac use single quotes, and Windows uses double quotes:
--listen port=8090 username=joe 'password=s3cret(!'
--listen port=8090 username=joe "password=s3cret(!"Note that the quotes are applied to the entire name=value pair, not just to the value part.
The system tiddlers provided as part of the core are named according to the following rules:
| Namespace | Format | Description |
|---|---|---|
$:/* | CamelCase | Root user interface tiddlers (eg control panel, advanced search) |
$:/config/* | CamelCase | User-oriented configuration setting |
$:/core/images/* | hyphen-case | Core images |
$:/core/modules/* | lowercase | JavaScript module tiddlers |
$:/core/save/* | lowercase | Saving templates for creating TiddlyWiki documents |
$:/core/templates/* | inconsistent | Templates needed for TiddlyWiki to operate. Currently uses a mix of dashes and periods to separate words |
$:/core/ui/* | inconsistent | Tiddlers comprising the default user interface of TiddlyWiki. Currently uses a mix of CamelCase and lowercase naming conventions |
$:/core/wiki/* | lowercase | Metadata about the entire wiki |
$:/docs/* | lowercase | Documentation tiddlers |
$:/messages/* | CamelCase | System messages |
$:/plugins/* | lowercase | Plugin tiddlers, and plugin content |
$:/snippets/* | inconsistent | Reusable snippets (will be replaced by macros) |
$:/state/* | lowercase | User interface state tiddlers |
$:/tags/* | CamelCase | User interface configuration tags |
$:/temp/* | lowercase | Temporary tiddlers that shouldn't be saved |
$:/themes/* | lowercase | Theme plugins |
In the format column:
- hyphen-case refers to joining multiple lowercase words with hyphens
- CamelCase refers to directly joining multiple lowercase words with initial uppercase letters
- lowercase refers to directly joining multiple lowercase words
- inconsistent marks namespaces that are currently titled inconsistently
Dans le mode de déroulé par défaut « classic », les tiddlers ouverts sont affichés verticalement dans une colonne appelée « cours du déroulé ». Il existe plusieurs façons de parcourir le déroulé — autrement dit, de rebondir d'un tiddler ouvert à l'autre.
- Une façon évidente consiste à faire défiler la page de bas en haut à l'aide de la barre de défilement du déroulé sur la droite.
- On notera que lorsque le cours du déroulé et la barre latérale s'étendent l'un et l'autre sous l'écran visible, deux barre de défilement apparaissent. La barre de défilement extérieure, soit la plus à droite, contrôle le cours du déroulé. La barre de déroulement intérieure contrôle la barre latérale.
- Une manière de procéder un peu maladroite mais souvent tentée par les nouveaux utilisateurs consiste à fermer les tiddlers un par un jusqu'à retrouver le tiddler qu'ils cherchent.
- Fermer un tiddler quelconque en haut ou au milieu du déroulé fera que tous les tiddlers situés en dessous remonteront le cours du déroulé. Le tiddler situé juste en dessous de celui que vous venez de fermer remontera d'un cran pour prendre sa place.
- Fermer le tiddler tout en bas du déroulé amènera le bas du tiddler situé juste au-dessus de lui dans le champ de vision.
- La meilleure approche consiste à utiliser l'onglet Ouverts dans la barre latérale pour cliquer directement sur le tiddler ouvert vers lequel vous souhaitez vous déplacer.
- L'onglet 'Ouverts' contient la liste de tous les tiddlers ouverts. Vous pouvez cliquer sur n'importe quel tiddler de la liste pour rebondir vers lui, ou cliquer sur le 'x' situé à côté pour le fermer. Il existe également un bouton 'Tout fermer' au bas de la liste des tiddlers ouverts.
Introduction
The navigator widget manipulates the current store, the story list and history lists in response to various Messages.
Content and Attributes
The navigator widget displays any contained content, and responds to Messages dispatched within it.
| Attribute | Description |
|---|---|
| story | Name of the tiddler containing the story list to be manipulated |
| history | Name of the tiddler containing the history list to be manipulated |
| openLinkFromInsideRiver | Determines the location for opening new tiddlers from links within the story river: at the top or bottom of the story river, or above or below the current tiddler |
| openLinkFromOutsideRiver | Determines the location for opening new tiddlers from linkes outside the story river: at the top or bottom of the story river |
Widget Messages
The following Messages are handled by the navigator widget:
- WidgetMessage: tm-cancel-tiddler
- WidgetMessage: tm-close-all-tiddlers
- WidgetMessage: tm-close-other-tiddlers
- WidgetMessage: tm-close-tiddler
- WidgetMessage: tm-delete-tiddler
- WidgetMessage: tm-edit-tiddler
- WidgetMessage: tm-import-tiddlers
- WidgetMessage: tm-new-tiddler
- WidgetMessage: tm-perform-import
- WidgetMessage: tm-save-tiddler
Variables
The following Variables are assigned by the navigator widget:
tv-story-list, giving the name of the tiddler containing the story listtv-history-list, giving the name of the tiddler containing the history list
| purpose | find which titles in a list field follow the input ones |
|---|---|
| input | a selection of titles |
| parameter | T = a tiddler title |
| output | a selection containing each title that immediately follows each of the input titles in the list field of T |
Each input title is processed in turn, and its successor is located in the list field and appended to the output. If a title is not listed in the field, or is the last title there, then it contributes nothing to the output.
These examples make use of the Days of the Week tiddler.
[[Monday]next[Days of the Week]]
[[Sunday]next[Days of the Week]]
Tuesday Wednesday Thursday +[next[Days of the Week]]
Node.js est une application téléchargeable sur votre ordinateur PC, Mac ou Linux, qui vous permet d'exécuter des programmes JavaScript. Contrairement aux programmes JavaScript s'exécutant dans un navigateur, le code tournant sur Node.js dispose d'un accès complet au système de fichiers et aux autres ressources de l'ordinateur, ce qui lui permet mener à bien des tâches traditionnellement dévolues à des langages comme Java, PHP et Python. Voir http://nodejs.org pour plus de détails.
Dans le cas de TiddlyWiki, Node.js permet de profiter d'un même code principal capable de tourner aussi bien dans le navigateur que sur le serveur, ce qui accroît encore sa souplesse d'utilisation.
Pour les utilisateurs finaux, le mode Node.js n'est pas plus compliqué à utiliser que le mode intégré au navigateur web, mais il donne accès à des fonctions puissantes, notamment la possibilité d'exécuter TiddlyWiki en tant que serveur web auquel vous pouvez vous connecter depuis d'autres appareils.
Voir TiddlyWiki sur Node.js pour plus de détails.
Version 5.0.11-beta includes some changes that can break content from earlier releases of TiddlyWiki 5.
Command line changes
Previously, commands that generate output files would interpret the specified path to the file as being relative to the current working directory. So, for example, the following command would write index.html to the current directory:
tiddlywiki mywiki --rendertiddler $:/core/save/all index.html text/plainIn 5.0.11-beta this behaviour has changed, and now the specified filename is resolved relative to an output folder within the TiddlyWikiFolder. So the command above will now write the file index.html to mywiki/output/index.html.
You can override this behaviour with the OutputCommand. For example, to generate the index.html file within the current directory:
tiddlywiki mywiki --output . --rendertiddler $:/core/save/all index.html text/plainA further change is that the --rendertiddlers command now clears the output folder before it writes any files. This means that any previous --rendertiddler commands to the same folder will have their output deleted.
Version 5.0.8-beta includes some changes that can break content from earlier releases of TiddlyWiki 5.
Change to $:/SiteTitle and $:/SiteSubtitle
You should rename any existing SiteTitle and SiteSubtitle tiddlers to $:/SiteTitle and $:/SiteSubtitle respectively.
Changed parsing rules for content of HTML elements
Version 5.0.8-beta marks a change in the way that TiddlyWiki determines whether to parse the content of an HTML element or widget in block mode or inline mode.
- In block mode, TiddlyWiki parses text into paragraphs, creating
<p>tags to wrap them. It also recognises block syntax like headings, lists and tables. - In inline mode, TiddlyWiki ignores paragraph formatting, and just recognises character formatting, like bold and italic.
It's important to be able to control which type of parsing is performed for different situations.
Prior to 5.0.8-beta, TiddlyWiki parsed the content of an element in inline mode unless the opening tag of the element were immediately followed by a line break. This meant that much of the time element tags would be shunted together into a long line, hindering readability.
The new behaviour for 5.0.8-beta is to parse the content of an element in inline mode unless the opening tag is immediately followed by two line breaks.
To adjust existing content for 5.0.8-beta you will need to manually add the additional line break after the opening tag of elements and widgets whose content should be parsed in block mode.
The positive aspect of the change is that it removes the need to pack multiple HTML tags onto a single line, improving readability.
Examples
Consider the difference between these two examples. First, here's an HTML tag that starts with two line breaks:
<blockquote>
! This is a heading
And a paragraph of text.
</blockquote>
Affichera ceci :
This is a heading
And a paragraph of text.
... Génération du HTML :
<blockquote><h1 class="">This is a heading</h1><p>And a paragraph of text.</p></blockquote>
Secondly, here's an HTML tag with just a single line break. Notice how the heading is no longer recognised as a heading
<blockquote>
! This is a heading
And a paragraph of text.
</blockquote>
Affichera ceci :
! This is a heading And a paragraph of text.
... Génération du HTML :
<p><blockquote> ! This is a heading And a paragraph of text. </blockquote> </p>
Changed commands for TiddlyWiki on Node.js
The handling of wiki folders has changed. Previously, if the tiddlywiki command was run against a wiki folder that didn't have the necessary tiddlywiki.info file then it would be automatically created. Now, the wiki folder must be initialised with the InitCommand.
This is how to create and start a new server-based wiki:
tiddlywiki mywikifolder --init server
tiddlywiki mywikifolder --serverNote that the name of the clientserver edition has changed to server.
Notifications are small informational messages that appear at the top right of the TiddlyWiki window, and automatically disappear after a preset time.
The now macro returns the current date and time in a specified format.
The value doesn't update automatically, like a ticking clock. It updates whenever the macro call is rendered, such as when the containing tiddler's display needs to be refreshed for some other reason.
Parameters
- format
- A string specifying the desired format, defaulting to
0hh:0mm, DDth MMM YYYY
Note: The format string [UTC]YYYY0MM0DD0hh0mm0ssXXX will return a date string representing the UTC time-stamp as it is used in the TiddlyWiki created and modified time-stamp fields.
La macro now renvoie la date et l'heure courantes, formatées d'après chaîne de caractères optionnelle.
Paramètres
| Position | Nom | Description | Défaut |
|---|---|---|---|
| 1 | format | Chaîne de type DateFormat spécifiant le format pour la date et l'heure | 0hh:0mm, DDth MMM YYYY |
Exemples
Par exemple :
* <<now>>
* <<now "DDth MMM YYYY">>Renvoie :
- 17:35, 3 février 2019
- 3 février 2019
| purpose | sort the input by number field |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as numbers |
! output | the input, likewise sorted into descending order |
| purpose | sort the input titles by number field, treating upper and lower case as different |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as numbers |
! output | the input, likewise sorted into descending order |
| purpose | select the Nth input title |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | the Nth input title |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]nth[]]
[list[Days of the Week]nth[5]]
NW.js est une application OpenSource qui étend les fonctionnalités d'un navigateur web avec celles de Node.js. Il permet l'utilisation d'application web d'une façon similaire aux applications natives, avec tous les accès au système de fichier et autres commodités natives. Allez plus loin sur le site officiel ou avec ce blog d'introduction (eng).
Voir TiddlyWiki sur NW.js pour plus de détails à ce sujet.
Une introduction à la bible d'Obadiah par Dave Gifford utilisant la macro sommaire et différents réglages personnalisés de TiddlyWiki : un bouton nouveau, ici, modifié ajout d'un viewtemplate personnalisé pour intégrer des notes ou des images dans tout tiddler, et un tiddler transcluant tout contenu, adapté pour faciliter l'impression (ce tiddler).
The official TiddlyWiki plugin library contains the plugins that are part of the main TiddlyWiki 5 GitHub repository. Install them from the plugin library. Plugins from the official plugin library are automatically updated as part of the upgrade process.
L'Open Source est définie par Wikipedia comme une philosophie, ou comme méthodologie éprouvée qui promeut la diffusion gratuite et l'accès libre à la conception et au code détaillé d'un produit fini.
Quand TiddlyWiki génère une liste de tiddlers portant un tag particulier (ex : la liste déroulante d'un tag pilule), it trie les tiddlers selon les règles suivantes :
- Commencer par tout tiddler declaré dans le champ
listdu tiddler, en suivant l'ordre donné. - Pour chaque tiddler
Trestant, chercher un champlist-before. s'il a le titre du tiddler comme valeur, placer le tiddlerTjuste avant celle-ci.- Au cas particulier, où le champ existe mais que sa valeur soit vide, placer
Tau tout début de la liste.
- Au cas particulier, où le champ existe mais que sa valeur soit vide, placer
- Pour chaque tiddler
Trestant, chercher un champlist-afterfield. S'il a le titre du tiddler title comme valeur, placer le tiddlerTjuste après ce dernier. - Si des tiddlers restent encore, les placer en queue de liste dans l'ordre alphabétique croissant des titres. Les différences entre majuscule et minuscule sont ignorées.
| purpose | selectively reverse the input list |
|---|---|
| input | a selection of titles |
| parameter | F = Either the string reverse or another value |
| output | the input, with the order reversed if F is the special value reverse |
Either reverses or preserves the order of the input list according to whether the parameter is the special value reverse.
En 1997, un collègue me montra le wiki original de Ward Cunningham. Que quelque chose d'aussi puissant puisse être écrit en seulement 700 lignes de Perl m'impressionna à l'époque, et j'étais aussi fasciné par la manière radicale dont la sécurité et le système de permissions avaient été repensés. Comme beaucoup d'autres développeurs, je me suis jeté sur tous les types de wiki qui me passaient sous la main, afin d'explorer leur utilisation en environnement de travail.
Le principal attrait du wiki pour moi était le sentiment qu'il pouvait remettre en question le paradigme qui prévalait jusqu'alors, à savoir les documents conçus pour être imprimés, et les emails.
Après avoir observé pendant quelques années la manière dont les gens utilisaient les wikis, j'ai remarqué que les utilisateurs avancés faisait grand usage de la possibilité d'ouvrir plusieurs pages de wiki à la fois dans les onglets de leur navigateur, pour se faciliter la comparaison et la révision des pages, la recopie de texte d'une page à l'autre, et pour se constituer une sorte de file de pages en attente d'être lues.
J'ai eu le sentiment que cette capacité à manipuler plusieurs pages en même temps était centrale dans la capacité à réorganiser un wiki, et on considère généralement qu'un wiki réorganisé avec amour a tendance à être plus utile. Pourtant, les interfaces utilisateur des wiki ont toujours été exclusivement conçues pour la présentation et la manipulation d'une seule page à la fois.
Toutes ces réflexions se sont synthétisées lorsque j'ai vu l'interface de Gmail en avril 2004, qui utilisait Ajax de manière ingénieuse pour assembler des mails individuels dans des fils de conversations.
J'ai commencer à expérimenter avec HTML et JavaScript pour pousser l'idée. Je n'avais eu jusqu'à présent pratiquement aucune expérience de l'un ou de l'autre, à part composer quelques pages statiques et des sites ASP simples dans des vies précédentes. Se plonger dans ces techniques orientées client a été une expérience douloureuse ; comme tout le monde, j'étais horrifié de découvrir l'atrocité des incompatibilités et incohériences de la programmation web.
Founded in 2004 by JeremyRuston, Osmosoft was originally a consultancy for software services around TiddlyWiki. Notable engagements included working with Socialtext on Socialtext Unplugged.
In 2007, Osmosoft was acquired by BT and became the champions for open source within the enterprise. As part of BT, Osmosoft has worked on a diverse range of projects within BT and for BT's customers.
Je constituais une équipe chez BT sous le nom Osmosoft. Nous avions comme objectif d'évangéliser les bénéfices de l'open source et d'aider d'autres équipes à réaliser ces bénéfices en pratique. Nous nous sommes aussi rendu compte qu'il était nécessaire d'évangéliser l'usage du Web en général, et les standards web en particullier.
Notre approche était de privilégier la démonstration sur le discours. Nous avons travaillé avec la communauté TiddlyWiki pour étendre l'écosystème, et nous avons construit de nombreux systèmes internes pour BT (certains basés sur TiddlyWiki, d'autres non).
La principale contribution d'Osmosoft à la communauté TiddlyWiki fut la création de TiddlyWeb et TiddlySpace. TiddlyWeb était un serveur robuste, capable de servir des tiddlers sur l'Internet, mais aussi de composer des vues TiddlyWiki à partir de ces tiddlers. Quant à TiddlySpace, il s'agissait d'une tentative pour packager TiddlyWeb de façon plus directement utilisable.
Change le répertoire de départ pour la sortie des prochaines commandes. Par défaut, le répertoire de sortie est le sous-répertoire output du répertoire de l'édition courante.
--output <nom de chemin>Si le chemin spécifié est relatif, il est calculé relativement au répertoire de sortie courant. Par exemple, --output . indique le répertoire courant comme répertoire de sortie.
The Oxford TiddlyWiki Interest Group meets monthly for discussions and demonstrations about TiddlyWiki.
See https://oxtwig.eventbrite.co.uk/ for details of our next meeting.
We have an email discussion list, too: https://groups.google.com/forum/#!members/oxtwig
OXTWIG #2
The second OXTWIG meeting was held on Thursday 16th January 2014:
OXTWIG #1
The first OXTWIG meeting was held on Thursday 21st November 2013:
Une caractéristique majeure dont plusieurs nouveaux utilisateurs ignorent le degré, est le point jusqu'auquel TiddlyWiki peut être personnalisé, juste par l'ajout, la suppression de tags système au sein de tiddlers shadow bien choisis ou dans vos propres tiddlers personnalisés.
- Vous pouvez ajouter et retrancher les fonctionnalités par défaut des tiddlers aussi bien en mode édition que visualisation (au cas où vous trouveriez un sous titre de tiddler distrayant ou que vous souhaitiez avoir un aide-mémoire à visualiser lors de l'édition de tiddler)
- Vous pouvez ajouter et retrancher les fonctionnalités par défaut de la mise en page globale (peut-être souhaitez-vous ajouter une horloge au menu latéral, ou remplacer les boutons de contrôle de la page par les vôtres
- Vous pouvez aussi revoir l'ordre dans lequel les fonctionnalités sont affichées (comme mettre les tags au dessus des titres des tiddlers, ou le sous-titre de votre TiddlyWiki sous les boutons de contrôles de la page)
Une fois que vous saurez ce que vous faites, tout cela sera vraiment plutôt facile à réaliser.
Ajout de tiddlers sur-mesure dans l'interface utilisateur
Vous pouvez aussi créer tout tiddler de votre choix avec le TagSystème approprié, il apparaitra en son lieu et place. Par exemple, si vous créez un tiddler 'Rappel automatique', ajouter le texte 'C'est un aide-mémoire' et étiquetez le $:/tags/EditTemplate, la phrase 'C'est un aide-mémoire' apparaitra dans chaque tiddler lors de son édition.
Quand vous afficherez de nouveaux tiddlers dans des tiddlers ou dans la mise en page générale, vous aurez probablement à les repositionner de sorte qu'ils apparaissent exactement où vous le souhaitez. Pour ce faire, modifiez le bon tiddler shadow muni du préfixe $:/tags/, et insérez-y le titre de votre tiddler dans le champ list, au bon endroit. Par exemple, si la phrase 'C'est un aide-mémoire', de l'exemple au-dessus, doit s'afficher au-dessus de l'éditeur de tags dans le mode édition, modifiez le tiddler $:/tags/EditTemplate, sélectionnez le champ 'list' field, et insérez [[Rappel automatique]] juste avant $:/core/ui/EditTemplate/tags.
Création de nouveaux boutons pour le MenuOutilVisu et les contrôles de page
Imaginons que vous ayez un tiddler squelette appelé 'Modèle Recette', et que vous souhaitiez un bouton dans le tiddler MenuOutilVisu pour créer des tiddlers 'nouvelle recette' à la demande. Cela nécessite les étapes suivantes :
- Pour illustrer votre bouton, si aucune des images du noyau (tiddlers shadow préfixés par $:/core/images/ ) n'est à votre convenance, vous devrez la créer ou en obtenir une au format SVG (par exemple, une de celles de http://flaticon.com), glissez-la dans votre fichier pour la transformer en tiddler, modifiez le tiddler et ajustez sa hauteur et sa largeur à 22px
- Passons au tiddler contenant votre tiddler. Créez-le, titrez-le et ajoutez le code du bouton (voir le code ci-dessous par exemple, en l'adaptant à vos besoins si nécessaire) Étiquetez-le par $:/tags/ViewToolbar
- Contrôlons la visibilité de votre tiddler dans la barre d'outil par la création d'un tiddler à titrer $:/config/ViewToolbarButtons/Visibility/Recette. Saisissez
revealdans la zone texte et sauvegardez. - Enfin, positionnons le bouton proprement. Ouvrez le tiddler $:/tags/ViewToolbar et insérez le titre de votre tiddler bouton (cf. titre étape précédente) dans le champ field au bon endroit.
\define newHereButtonTags()
[[$(currentTiddler)$]]
\end
\define newHereButton()
<$button class=<<tv-config-toolbar-class>>>
<$action-sendmessage
$message="tm-new-tiddler"
$param="TITLE DE VOTRE BOUTON SQUELETTE"
title="New tiddler"
tags=<<newHereButtonTags>> />
<$list filter="[<tv-config-toolbar-icons>prefix[yes]]">
{{TITRE DE VOTRE TIDDLER IMAGE SVG}}
</$list>
<$list filter="[<tv-config-toolbar-text>prefix[yes]]">
<span class="tc-btn-text"><$text text="CAPTION DE VOTRE BOUTON"/></span>
</$list>
</$button>
\end
<<newHereButton>>Supprimer les tiddlers shadows de l'interface utilisateur
Dans l'onglet 'Plus' > option 'Shadows' sont listés tous les tiddlers shadows. Dans cette liste se trouvent plusieurs tiddlers préfixés $:/core/ui/. Ce sont les tiddlers du noyau définissant l'interface utilisateur. Ces tiddlers sont étiquetés par des Tags système, supprimer ou ajouter ces tags modifie la présentation de la page et des tiddlers.
Par exemple, $:/core/ui/SideBar/More est le tiddler correspondant à l'onglet 'plus' du menu latéral, étiqueté par le Tag système $:/tags/SideBar de façon à apparaître dans le menu latéral. Supprimer ce tag de ce tiddler supprime le tag du menu, et lui réajouter ce tag le fera y réapparaître.
Vous pouvez suivre le même procédé pour tout tiddler du noyau définissant l'interface utilisateur et donc préfixé par $:/core/ui/. Ainsi encore, supprimer le Tag Système $:/tags/ViewTemplate du tiddler $:/core/ui/ViewTemplate/subtitle fera disparaître les sous-titres de tous les tiddlers.
Modifier un tiddler shadow de cette façon remplacera la valeur par défaut. Pour réinitialiser, il suffit de supprimer le tiddler modifié pour restaurer le tiddler shadow sous-jacent.
Pour marquer la fin d'un paragraphe, il faut appuyer deux fois sur la touche Entrée pour créer deux retours à la ligne :
Ceci est un premier paragraphe.
Et ceci est un deuxième paragraphe.- Remarque
- Peu importe le nombre de retours à la lignes supplémentaires, l'espacement entre les paragraphes reste le même.
Au sein d'un paragraphe, un retour à la ligne seul est ignoré :
Ceci est un
paragraphe constitué
de plusieurs
lignes courtes.Pour les situations où ce comportement n'est pas pratique, voir aussi : WikiTexte : Fin de ligne.
Fournit un mot de passe pour les prochaines opérations de chiffrement.
--password <motdepasse>Note : Cette commande n'est pas appropriée pour servir un TiddlyWiki protégé par mot de passe. Pour cela, utilisez plutôt l'option password de la commande Server.
Introduction
The password widget displays a password input box that is bound to a named entry in the TiddlyWiki5 PasswordVault. Passwords are currently stored in the browsers local storage and are not themselves encrypted.
Content and Attributes
The content of the <$password> widget is ignored.
| Attribute | Description |
|---|---|
| name | Name of the password vault entry |
L'encodage PourCent est une notation qui permet d'inclure des caractères invalides dans une URI.
Ce type de caractère est représenté par le signe % suivi de deux caractères additionnels.
Par exemple, l'espace est représenté par %20 et le signe pourcent est représenté ainsi %25.
TiddlyWiki ships with defaults that are designed to get the best out of modern devices from smartphones to desktop computers. If you need to work on older, less powerful devices, or work with large amounts of content, there are a few steps you can take to improve performance.
- Avoid the "Recent" tab. It is computationally slow to generate and update in response to tiddler changes.
- Use the "Vanilla" theme. The default "Snow White" theme includes visual effects like shadows, transparency and blurring that can be slow to render on older devices
- Avoid large tiddlers. Large bitmaps can significantly slow TiddlyWiki's performance. For example, an image taken with a modern smartphone will often be 5MB or more. Use ExternalImages whenever possible
- Don't have too many tiddlers open at once. Every tiddler you have open will require processing to keep it up to date as the store changes (for example, while you type into a draft tiddler). It is particularly easy when using zoomin story view to end up with dozens of tiddlers listed in the Open tab in the sidebar. Get into the habit of periodically closing all open tiddlers with the close all button
Les permaliens offrent la possibilités de faire des liens directs vers des tiddlers individuels dans un TiddlyWiki.
La forme simple des permaliens
La forme la plus simple d'un permalien vers un tiddler cible unique est son nom précédé de "#" accolé au lien URL de base :
https://tiddlywiki.com/#HelloThere
Le titre du tiddler peut contenir des espaces si nécessaire :
https://tiddlywiki.com/#Using TiddlyWiki on Node.js
Remarquez que les doubles crochets ne sont pas requis autour du titre du tiddler cible ; cependant, s'ils sont présents ils seront supprimés automatiquement.
(NDT Attention en cas de traduction, c'est le lien doit pointer vers title le titre original et pas vers le titre traduit affiché qui ne reflète que le contenu du champ fr-title)
Permaliens vers un déroulé
Le permalien peut aussi spécifier le déroulé de la liste de tiddlers qui seront ouverts avec le Tiddler Filtre cible :
https://tiddlywiki.com/#TiddlerFields:Tiddlers TiddlerTags TiddlerFields ContentType
Si le tiddler cible est absent du déroulé de la liste, il est alors automatiquement inséré au début. Ce qui veut dire que les exemples suivants ciblent tous les deux le tiddler Tiddlers avec le déroulé de la suite Tiddlers, Tags, TiddlerFields:
https://tiddlywiki.com/#Tiddlers:Tags TiddlerFields
https://tiddlywiki.com/#Tiddlers:Tiddlers Tags TiddlerFields
Il est aussi possible de spécifier, pour les besoins de la navigation, un déroulé filtre sans spécifier de tiddler cible :
https://tiddlywiki.com/#:[tags[task]]
Concernant le codage URL
Il existe des restrictions techniques aux caractères légaux d'un adressage URL. Afin de permettre à tous les titres de tiddler d'être adressés, les caractères illégaux font l'objet d'un processus appelé "codage URL" où les caractères problématique sont remplacés par leurs codes numériques. Par exemple, le caractère espace est remplacé par %20.
Aussi bien le tiddler cible que le déroulé filtre seront encodé (mais pas le séparateur ":"). TiddlyWiki génère des URLs encodées correctement qui peuvent paraître un peu "moche". Cependant, dans la pratique les navigateurs parviennent heureusement et parfaitement à interpréter des caractères arbitraires dans les extraits URL. De ce fait, quand vous créez des permaliens manuellement vous pouvez choisir d'ignorer le codage URL.
Comportement de TiddlyWiki avec les Permaliens
Deux aspects importants du comportement de TiddliWiki avec les permaliens peuvent être réglés avec les options de l'onglet Réglages avancés du $:/ControlPanel :
- d'une part la mise à jour automatique de la zone d'adresse à chaque navigation, et dans ce cas s'il faut inclure la séquence du déroulé aussi bien que le tiddler cible
- d'autre part si les mises à jour de la zone d'adresse doivent affecter l'historique du navigateur. Par défaut, c'est non ; mais lorsque que oui est sélectionné, vous pouvez reprendre votre navigation entre les tiddlers en utilisant les boutons avancer et reculer du navigateur
Notez que saisir un permalien ou s'y rendre causera toujours le traitement du permalien, et les tiddlers ouverts ou fermés en fonction de lui.
Détails techniques
Quand TiddlyWiki se lance il traite les permaliens selon les étapes suivantes ; les même étapes sont répétées dynamiquement lors des modifications du permalien (cela survient en réaction à l'édition par l'adresse de la barre d'adresse, par exemple).
- Si le permalien contient un ":", traiter la chaine précédente comme la cible et la chaine qui suit comme le filtre du déroulé
- Si ":" est absent, traiter toute la chaine comme la cible et marquer le filtre du déroulé comme non-spécifié
- Si le filtre du déroulé est non-spécifié dans le processus de lancement, alors mettre une chaine vide dans le filtre du déroulé si la cible est spécifiée, ou aux tiddlers par défaut si la cible n'est pas spécifiée
- Si le filtre du déroulé est non-spécifié hors du processus de lancement, alors affecter le déroulé actuel au filtre du déroulé
- Évaluer le filtre du déroulé comme liste du déroulé
- Si la cible est spécifiée et absente de la liste du déroulé alors l'ajouter au début
- Si la cible est spécifiée alors s'y rendre, autrement naviguer au premier tiddler de la liste du déroulé
Un développement pour planifier les cours créés avec TiddlyWiki.
J'ai développé un logiciel pour assister dans la saisie et la mémorisation des information de planification des cours et ainsi faciliter/automatiser un ennuyeux travail lors de à la création du document actuel de planification des leçons.
Lorsqu'on enregistre et organise des informations, on se donne pour objectif de pouvoir les réutiliser plus tard. La valeur d'une information conservée est directement proportionnelle à la facilité avec laquelle on peut la réutiliser.
La philosophie des tiddlers consiste à maximiser les possibilités de réutilisation en découpant l'information en unités sémantiques aussi petites que possible, grâce à une modélisation riche des relations entre elles. On utilise ensuite l'agrégation et la composition pour tisser les fragments entre eux afin de construire des déroulés cohérents.
TiddlyWiki a pour ambition de proposer une algèbre pour les tiddlers : une manière concise d'exprimer et d'explorer les relations entre les diverses pièces d'information.
These editions contain simple demos of the original set of TiddlyWiki plugins. They were prepared for earlier versions of TiddlyWiki that lacked the plugin library.
Plugin fields
Plugins are stored as tiddlers with the following fields:
| Field | Description |
|---|---|
| title | Title of plugin |
| description | Description of plugin |
| author | Author of plugin |
| version | Version string (must conform to SemanticVersioning convention) |
| source | Source URL of plugin |
| type | Must be application/json |
| plugin-type | Can be plugin (default), language or theme |
| text | JSON encoding of the list of tiddlers comprising the plugin |
| list | Names of exposed plugin information tiddlers (see below) |
| name | Name of the theme (only for themes) |
| dependents | List of dependent plugins (currently only implemented for themes) |
Information Tiddlers for Plugins
Plugin authors are encouraged to provide special information and documentation tiddlers that TiddlyWiki can include as plugin information tabs in the control panel.
Plugins should provide an icon contained in a tiddler with the title formed of <plugin-name>/icon (for example, $:/core/icon).
Plugins expose the names of the individual information tabs that they wish to display in the list field of the plugin tiddler. By convention, some or all of the following should be provided:
- readme: basic information about the plugin
- license: the license under which the plugin is published
The title of the associated information tiddler must be formed as follows:
$:/<plugin-name>/<current-language>/<tab-name>(for example, $:/core/en-GB/readme)$:/<plugin-name>/<tab-name>(for example, $:/core/readme)
Thus, plugins can provide language-specific versions of each information tiddler.
Note that information tiddlers should not reference other tiddlers within the plugin. This is because plugins containing themes or languages are dynamically switched in and out as they are selected, and so their information tiddlers may not be available for viewing. The control panel uses the 'subtiddler' attribute of the TranscludeWidget to access these tiddlers, which works independently of the plugin switching mechanism.
On the server, plugins can be stored as ordinary JSON tiddlers but it is often more convenient to store them as separate tiddler files within folders. Plugin folders must contain a plugin.info file that contains the metadata for the plugin. It can also optionally identify files external to the plugin folder that should be loaded as tiddlers.
The plugin.info file should contain the following JSON structure:
The JSON structure for plugin tiddlers is as follows:
{
"title": "$:/plugins/publisher/name",
"description": "An exemplary plugin for demonstration purposes",
"author": "JeremyRuston",
"version": "1.2.3-alpha3",
"core-version": ">=5.0.0",
"source": "https://tiddlywiki.com/MyPlugin",
"plugin-type": "plugin",
"list": "readme license history"
}By convention, the titles of the individual tiddlers are prefixed with the title of the containing plugin, but they are not restricted to do so.
Note that if the version field is omitted from a plugin.info file when the plugin folder is packed then it is automatically filled in by the core to the current core version number. This is to ensure that all the core plugins carry the correct version number. Generally plugin authors will want to ensure that they do explicitly specify a version number.
Introduction
Plugins are bundles of tiddlers that are distributed and managed as a single unit by being packed into a single JSON tiddler. Users can install them with drag and drop, or using the plugin library.
The tiddlers within registered plugins behave as ShadowTiddlers: they can be freely overwritten by creating a tiddler with the same title, but deleting that tiddler restores the underlying tiddler value from the plugin.
Plugins have a plugin-type field that may take the following values:
plugin(default) - a plain plugintheme- a theme plugin (see ThemeMechanism)language- for translations only
Plugins can be used to package ordinary content, or can include JavaScript modules that extend and enhance the core TiddlyWiki5 functionality.
Plugins conventionally have a title of the form $:/plugins/publisher/name. Plugins that are part of the core TiddlyWiki distribution have titles of the form $:/plugins/tiddlywiki/name.
When running TiddlyWiki under Node.js, plugins can also be stored as individual tiddler files in PluginFolders.
More information
Plugins Disponibles
Ces plugins sont distribués sur tiddlywiki.com comme des éléments de la distribution principale à part entière.
- Plugin CodeMirror
- Plugin D3
- Plugin Highlight
- Installing a plugin from the plugin library
- Plugin KaTeX
- Manually installing a plugin
- Plugin Markdown
- OfficialPlugins
- Plugin Railroad
- Plugin TW2Parser
- Uninstalling a plugin
Qu'est-ce qu'un plugin?
Un plugin, dans TiddlyWiki5, est un ensemble de tiddlers empaquetés dans un seul tiddler. Les Plugins sont utilisés pour distribuer des composants optionnels et personnalisés de TiddlyWiki.
Les tiddlers d'un plugin deviennent des tiddlers shadow.
Les Plugins peuvent contenir des modules JavaScript, des feuilles de styles, et des gabarits pour étendre les fonctionnalités de TiddlyWiki lui-même. Les plugins peuvent aussi être employés pour diffuser du texte oridinaire, des images ou tout autre contenu. Leurs mise à jour depuis leur source les traite comme une simple unité.
Se reporter au Mécanisme du Plugin pour plus de détail sur la façon dont les plugins sont implémentés en interne.
Installation d'un plugin à partir d'une bibliothèque de plugins
- Faites une sauvegarde du fichier HTML TiddlyWiki (voir à ce propos)
- Ouvrez votre TiddlyWiki dans un navigateur
- Ouvrez le Panneau de contrôle, cliquez sur l'onglet Plugins, et à nouveau sur un nouvel onglet Plugins
- Cliquez sur le bouton Installez un plugin
- À l'affichage de la bibliothèque officielle :
- Choisir entre plugins, thèmes et langages
- Utilisez la recherche et cliquez sur le chevron d'un plugin pour obtenir des détails
- Cliquez sur le bouton installez
- Une barre d'alerte vous propose de cliquer sur Sauvegarder puis de Rafraichir la page afin que les modifications soient prises en compte par TiddlyWiki
- Le plugin est maintenant prêt à être utilisé
Installation manuelle d'un plugin
- Faites une sauvegarde du fichier HTML TiddlyWiki (voir à ce propos)
- Ouvrez votre TiddlyWiki dans un navigateur
- Cherchez le lien vers le plugin, de type $:/plugins/tiddlywiki/exemple. Vous trouverez habituellement ce lien sur la page d'accueil du plugin (voir par exemple, https://tiddlywiki.com/plugins/tiddlywiki/katex/)
- Glissez le lien de type $:/plugins/tiddlywiki/exemple vers la fenêtre du navigateur affichant votre TiddlyWiki
- Sauvegardez votre TiddlyWiki
- Rafraichir la page afin que les modifications soient prises en compte
- Le plugin est maintenant prêt à être utilisé
Comment désinstaller/ supprimer un plugin
- Faites une sauvegarde du fichier HTML TiddlyWiki (voir à ce propos)
- # Ouvrez le Panneau de contrôle, cliquez sur l'onglet Plugins, et à nouveau sur un nouvel onglet Plugins
- Cliquez sur le plugin que vous voule supprimer pour ouvrir son tiddler
- Cliquez sur l'icone d'édition, puis sur l'icone de suppression du tiddler
- Sauvegardez votre TiddlyWiki
- Rafraichir la page afin que les modifications soient prises en compte
- Le plugin est maintenant désinstallé
A collection of plugins from TheDiveO.
TheDiveO's Third Flow plugin construction system:
The ThirdFlow plugin brings to you another way to develop customization plugins for TiddlyWiki 5. It is not enforcing a specific development flow, it simply tries to help you. Otherwise, it tries to stay out of your way.
TheDiveO's FontAwesome plugin:
The FontAwesome plugin supports embedding Font Awesome in TiddlyWiki 5. There is no need to install this font into your operating system in order to use it with TiddlyWiki 5. The font is already embedded in this TiddlyWiki 5 customization plugin instead, so nothing else to install.
A collection of plugins from Uwe Stuehler, including:
- Material Edition, a theme based on Google's "material" design language
- A wrapper for the MUURI plugin, bringing complex "masonry"-style layouts to TiddlyWiki
| purpose | select all shadow titles in the input plugins |
|---|---|
| input | a selection of plugin tiddler titles |
| parameter | none |
| output | all shadow titles contained in the input plugins |
The popup mechanism allows blocks of content to be selectively displayed and positioned with respect to an anchor. It has several parts:
- StateTiddlers to record whether a popup is currently displayed or not
- The RevealWidget to selectively display the popup content
- For "sticky" popups — those that don't close when clicking inside one — set the class attribute to
tc-popup-keep
- For "sticky" popups — those that don't close when clicking inside one — set the class attribute to
- The ButtonWidget to trigger the display of the popup by setting the state tiddler appropriately
Un pragma est un composant spécial de WikiText qui permet de contrôler la façon dont la suite du texte est analysée.
Les Pragmas occupent les lignes débutants par \. Ils peuvent juste prendre place au début d'un texte, mais des lignes vides sont permises entre eux. Si un pragma apparait dans le corps principal d'un texte, il est considéré comme du texte ordinaire.
Les pragmas suivants sont disponibles :
\define- définit une macro
\rules- permet d'ajuster l'ensemble des règles d'analyse d'un texte
| purpose | filter the input titles by how they start |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | those input titles that start with S |
! output | those input tiddlers that do not start with S |
In looking for matches for S, capital and lowercase letters are treated as different.
[tag[task]!prefix[Go]]
[prefix[$:/languages/]]
[prefix[$:/]]
[is[system]]| purpose | prepend a range of items from an array to the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to all |
| parameter | list = the array of items to be prepended to the head of the list |
| output | a list with items prepended from the head of the operand array |
! output | a list with items prepended from the tail of the operand array |
These examples make use of the Days of the Week tiddler.
The operator may be used to prepend a number of items to the list.
[list[Days of the Week]prepend[Yesterday Today Tomorrow]]
The operand may list only items without spaces – to include items with spaces, use a reference to an array e.g. prepend the last three short days of the week to the list
[list[Days of the Week]!prepend:3{Days of the Week!!short}]
Ordinairement, le lancement de TiddlyWiki affiche les tiddlers spécifiés par le filtre du tiddler $:/DefaultTiddlers.
Quelquefois il est utile de réouvrir les mêmes tiddlers ouverts au moment de la sauvegarde du fichier. Pour cela, régler $:/DefaultTiddlers à ce filtre :
[list[$:/StoryList]]Ce filtre renvoie les filtres spécifiés dans le tiddler $:/StoryList, le tiddler système que TiddlyWiki utilise pour mémoriser la suite de tiddlers du déroulé actuel.
| purpose | find which titles in a list field precede the input ones |
|---|---|
| input | a selection of titles |
| parameter | T = a tiddler title |
| output | a selection containing each title that immediately precedes each of the input titles in the list field of T |
Each input title is processed in turn, and its predecessor is located in the list field and appended to the output. If a title is not listed in the field, or is the first item there, then it contributes nothing to the output.
These examples make use of the Days of the Week tiddler.
[[Wednesday]previous[Days of the Week]]
[[Monday]previous[Days of the Week]]
Tuesday Wednesday Thursday +[previous[Days of the Week]]
| purpose | move N trailing items after the marker |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | marker = the list item to be used as a marker |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[putafter[Wednesday]]
[list[Days of the Week]] +[putafter:2[Tuesday]]
[list[Days of the Week]] [[Yesterday]] [[Today]] [[Tomorrow]] +[putafter:3[Tuesday]]
| purpose | move N trailing items before the marker |
|---|---|
| input | a selection of titles |
| suffix | an integer N, defaulting to 1 |
| parameter | marker = an integer, defaulting to 1 |
| output | the first N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[putbefore[Wednesday]]
[list[Days of the Week]] +[putbefore:2[Tuesday]]
[list[Days of the Week]] [[Yesterday]] [[Today]] [[Tomorrow]] +[putbefore:3[Tuesday]]
| purpose | move N trailing items to the head of the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | ignored |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[putfirst[]]
[list[Days of the Week]] +[putfirst:2[]]
[list[Days of the Week]] [[Yesterday]] [[Today]] [[Tomorrow]] +[putfirst:-2[]]
| purpose | move N leading items to the tail of the list |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | ignored |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[putlast[]]
[list[Days of the Week]] +[putlast:2[]]
one two three [list[Days of the Week]] +[putlast:-3[]]
Answer: New in: 5.1.16
If tiddler has both: this AND tag that create an orange border.
[data-tags*="bar"][data-tags*="froz"] {
border: 2px solid orange;
}If your CSS looks like this:
[data-tags~="this"] {
border: 2px solid blue;
}
[data-tags~="that"] {
border: 2px solid red;
}this creates a blue border
that creates a red border
If you swap positions, you get it the other way around.
Answer: New in: 5.1.16
Either tag this or tag that create a red border.
[data-tags~="this"],
[data-tags~="that"] {
border: 2px solid red;
}Consider the following usecase: New in: 5.1.16
There is a field named: rank, which can hold different values eg: species.
Answer:
The idea is now: We dynamically create the stylesheet. The style-sheet can look like this:
title: myStyles
tags: $:/tags/Stylesheet
<$list filter="[rank[species]]">
[data-tiddler-title^="<$view field=title/>"] .tc-tiddler-body {
column-count: 2;
}
</$list> This creates a CSS rule for every tiddler-title, that has a field rank and value species.
Answer: New in: 5.1.16
- If a tiddler has no tags, but needs styling use:
data-tiddler-titleas CSS selector- There is only one tiddler
- If a user wants to style system tiddlers in a custom way: use:
[data-tiddler-title^="$:"/]as a selector- using the TW namespace functionality
- If the user wants special behaviour for tagged tiddlers. eg: Learning
- use:
[data-tags*="Learning"]as CSS selector.
- use:
The names I'm using are only used for documentation purpose, without changing the existing wiki. I don't want, that the docs has side effects.
The qualify macro is an important part of the StateMechanism.
It returns a unique string that encodes its position within the widget tree, as identified by the stack of transcluded tiddlers that lead to that position.
It is implemented using the transclusion variable.
Parameters
- title
- The prefix for the returned string, normally a tiddler title
The results returned by the qualify macro depend on its location in the transclusion stack.
The two examples below are identical, but produce different results because the second one has been transcluded from another tiddler.
Each example shows the result of calling qualify and then the value of the transclusion variable.
<ul>
<li><code><<qualify "BaseTiddler">></code></li>
<li><code><<transclusion>></code></li>
</ul><ul> <li><code><<qualify "BaseTiddler">></code></li> <li><code><<transclusion>></code></li> </ul>
Une Quine est un programme d'ordinateur qui se programme lui-même.
TiddlyWiki est un exemple inhabituel de quine : c'est lié à la capacité de son noyau à produire une copie de son propre code source pour sauver indépendamment ses propres modifications.
Introduction
The radio widget displays an HTML <input type="radio"> that reflects whether a given tiddler field has a specified value. Selecting the radio button sets to the tiddler field to the value.
Content and Attributes
The content of the <$radio> widget is displayed within an HTML <label> element also containing the radio button. This means that clicking on the content will have the same effect as clicking on the button itself.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler to manipulate (defaults to the current tiddler) |
| field | The field of the tiddler bound to the radio button |
| index | New in: 5.1.14 The index of the tiddler being DataTiddler bound to the radio button |
| value | The value for the field or index of the tiddler |
| class | The CSS classes assigned to the label around the radio button |
Field Mode
This example uses the radio widget to change the modifier field of this tiddler:
<$radio field="modifier" value="JoeBloggs"> Joe Bloggs</$radio>
<$radio field="modifier" value="JaneBloggs"> Jane Bloggs</$radio>Affichera ceci :
Index Mode
Using the radio widget in index mode requires the index attribute to specify the name of the index of a DataTiddler to which the specified value is assigned.
This example sets the Tree Frog index in the tiddler AnimalColours:
<$tiddler tiddler="AnimalColours">
<$radio index="Tree Frog" value="green"> green</$radio>
<$radio index="Tree Frog" value="brown"> brown</$radio>
</$tiddler>Affichera ceci :
Railroad diagrams, sometimes called syntax diagrams, are a visual way of explaining the syntax rules of a computer language. Reading one is like reading a public transport map.
Each diagram starts on the left and ends on the right. Simply follow any line from the startpoint to the endpoint. All the alternative lines are equally valid. A line will sometimes jump over an item that is optional, or loop back to indicate that an item can be repeated.
In the example above, a comma appears between each occurrence of the repeated item. The comma path runs from right to left, and can only be reached by first passing through repeated.
Characters in round boxes are literal, i.e. they denote themselves. A name in a rectangular box denotes a further railroad diagram.
The railroad diagrams in TiddlyWiki's documentation are generated with the Railroad Plugin.
Ce plugin propose le widget <$railroad> pour générer des diagrammes chemin de fer en images SVG.
De plus, le diagramme de notation peut être stocké dans un tiddler dédié avec son champ type réglé sur text/vnd.tiddlywiki.railroad, ce tiddler pourra être ainsi simplement transclu partout où il sera nécessaire.
Le plugin est basé sur une bibliothèque de Tab Atkins qui a été étendue pour la rendre plus malléable, notamment par la possibilité des composant d'un diagramme de fonctionner comme des liens ou d'être transclus à partir d'autres tiddlers.
Le widget railroad utilise une notation spéciale pour construire les composants définis çi-après.
Ici, x et y remplacent tout composant.
Les noms (contrairement aux chaines cotées) ne sont composés que de valeurs débutant par une lettre et contenant seulement lettres, chiffres, soulignements, points et traits d'union.
- série
- Une série de composants
- Les délimiteurs
<-et->permettent d'obliger un composant unique à être traité comme une série. C'est parfois utile pour mettre en valeur un diagramme
- optionnel
- Un composant qui peut être omis
- Les deux points font qu'
xsoit en tout premier
- répété
- Une liste d'un ou plusieurs
x - Le suffixe
+ajouteycomme séparateur entre toutxet le suivant
- répétition optionnelle
- Une liste optionnelle de
x, i.e. une liste de zéro ou plusieursx
- choix
- Un ensemble d'alternatives
- Les deux points indiquent quelle branche arrive en tout premier. Par défaut, c'est la première branche
- chaine / terminal
- Un composant littéral ou terminal
- Ci-après les règles TiddlyWiki normales pour les chaines cotées
- nonterminal
- Un composant nonterminal, i.e. le nom d'un autre diagramme
- commentaire
- Un commentaire
- dummy
- L'absence de composant
- lien
- Un lien vers le titre d'un tiddler ou l'URI donné par la chaine ou le nom
- transclusion
- Interprète le contenu d'un autre tiddler comme un diagramme syntaxique et le transclut dans le diagramme courant
- pragma arrow
- Contrôle si les chemins répétés ont une flêche ou pas
- Peut être réglé sur oui ou non dans un diagramme intermédiaire, si désiré
- pragma debug
- Provoque l'affichage du diagramme syntaxique d'un diagramme
- pragma start/end
- Règle le style des diagrammes startpoint ou endpoint
| purpose | generate a range of numbers |
|---|---|
| input | ignored |
| parameter | N = a range specification, like [1,5] |
| output | a series of evenly spaced numbers ranging from <begin> to <end> |
The range operator produces a list of numbers counting up or down. It's useful for counting and numbering, or in combination with the Formula Plugin.
| Purpose | produce a range of numbers |
|---|---|
| Input | ignored. |
| Parameter | 1-3 numbers separated by , or ;. |
| Output | A series of evenly spaced numbers ranging from <begin> to <end> |
! Output | As Output, but with order reversed. |
The parameter has three forms:
| Parameter | Output |
<end> | Whole numbers up to <end>. |
<begin>,<end> | Numbers from <begin> to <end>, spaced by whole numbers. |
<begin>,<end>,<step> | Numbers from <begin> to <end> spaced out by <step>. |
Each part must be a number, and works as follows:
<begin>: start counting at this number.- Defaults to 1 if
<end>is at least 1 (or -1 if<end>is at most -1).
- Defaults to 1 if
<end>: stop counting at this number.- This number will appear in the list unless it falls between two steps.
<step>: count up (or down) by this amount.- Defaults to 1.
- Cannot be zero.
- We always count from
<begin>toward<end>, whether<step>is positive or negative.
The number of decimal points in the output is fixed, and based on the parameter with the most decimal points.
To prevent the browser from freezing, range is currently limited to 10,000 values.
Examples
[range[7]]1 2 3 4 5 6 7
[range[1, 10]]1 2 3 4 5 6 7 8 9 10
[range[17,13]]17 16 15 14 13
[range[1.001, 5, 1]]1.001 2.001 3.001 4.001
[range[.5,1.4,.004]]0.500 0.504 0.508 0.512 0.516 0.520 0.524 0.528 0.532 0.536 0.540 0.544 0.548 0.552 0.556 0.560 0.564 0.568 0.572 0.576 0.580 0.584 0.588 0.592 0.596 0.600 0.604 0.608 0.612 0.616 0.620 0.624 0.628 0.632 0.636 0.640 0.644 0.648 0.652 0.656 0.660 0.664 0.668 0.672 0.676 0.680 0.684 0.688 0.692 0.696 0.700 0.704 0.708 0.712 0.716 0.720 0.724 0.728 0.732 0.736 0.740 0.744 0.748 0.752 0.756 0.760 0.764 0.768 0.772 0.776 0.780 0.784 0.788 0.792 0.796 0.800 0.804 0.808 0.812 0.816 0.820 0.824 0.828 0.832 0.836 0.840 0.844 0.848 0.852 0.856 0.860 0.864 0.868 0.872 0.876 0.880 0.884 0.888 0.892 0.896 0.900 0.904 0.908 0.912 0.916 0.920 0.924 0.928 0.932 0.936 0.940 0.944 0.948 0.952 0.956 0.960 0.964 0.968 0.972 0.976 0.980 0.984 0.988 0.992 0.996 1.000 1.004 1.008 1.012 1.016 1.020 1.024 1.028 1.032 1.036 1.040 1.044 1.048 1.052 1.056 1.060 1.064 1.068 1.072 1.076 1.080 1.084 1.088 1.092 1.096 1.100 1.104 1.108 1.112 1.116 1.120 1.124 1.128 1.132 1.136 1.140 1.144 1.148 1.152 1.156 1.160 1.164 1.168 1.172 1.176 1.180 1.184 1.188 1.192 1.196 1.200 1.204 1.208 1.212 1.216 1.220 1.224 1.228 1.232 1.236 1.240 1.244 1.248 1.252 1.256 1.260 1.264 1.268 1.272 1.276 1.280 1.284 1.288 1.292 1.296 1.300 1.304 1.308 1.312 1.316 1.320 1.324 1.328 1.332 1.336 1.340 1.344 1.348 1.352 1.356 1.360 1.364 1.368 1.372 1.376 1.380 1.384 1.388 1.392 1.396 1.400
Introduction
The range widget displays an HTML <input type="range"> that reflects a given tiddler field numeric value. Adjusting the radio button sets the tiddler field to the value.
Content and Attributes
The content of the <$range> widget is ignored.
| Attribute | Description |
|---|---|
| tiddler | Title of the tiddler to manipulate (defaults to the current tiddler) |
| field | The field of the tiddler bound to the radio button |
| min | The minimum value to be able to be set by the <$range> widget. |
| max | The maximum value to be able to be set by the <$range> widget. |
| increment | The minimum amount by which a value may be changed. Defaults to 1. |
| default | The default value displayed if the field is missing or empty. |
| class | CSS classes to be assigned to the label around the radio button |
Examples
Range -1 to 10
<$range tiddler="$:/_RangeDemo/1" min="-1" max="10" default="1" increment="1"/> {{$:/_RangeDemo/1}}Affichera ceci :
Range 0 to 1
<$range tiddler="$:/_RangeDemo/2" min="0" max="1" default=".01" increment=".01"/> {{$:/_RangeDemo/2}}Affichera ceci :
Featuring plugins that integrate two interesting new capabilities:
- SocialCalc providing a powerful spreadsheet
- Three.js providing interactive 3D graphics
I developed some plugins related to engineering tasks.
After using them for personal projects I'm glad to share with TiddlyWiki community.
Bienvenue sur TiddlyWiki, un carnet de notes personnel web et non-linéaire que tout le monde peut utiliser et conserver, sans dépendre d'une quelconque entreprise.
TiddlyWiki est un wiki interactif en JavaScript. Il peut être utilisé dans le navigateur sous forme de fichier HTML autonome ou comme une puissante application Node.js. Il est extrêmement personnalisable : l'interface utilisateur dans son intégralité est elle-même implémentée en WikiText recomposable à volonté.
Plus d'informations et démonstrations sur https://tiddlywiki.com
Installation de TiddlyWiki sur Node.js
- Installez Node.js depuis http://nodejs.org
- Ouvrez un terminal en ligne de commande et tapez :
npm install -g tiddlywikiSi cela échoue avec un message d'erreur, il se peut que vous ayez besoin de retaper la commande en tant qu'administrateur :
npm install -g tiddlywiki(Windows)sudo npm install -g tiddlywiki(Mac/Linux) - Vérifiez que TiddlyWiki est bien installé en tapant :
tiddlywiki --version - En réponse, vous devriez voir TiddlyWiki renvoyer la version en cours (par exemple
5.1.2; d'autres informations de débogage peuvent aussi apparaître). - Faites l'essai :
tiddlywiki monnouveauwiki --init serverpour créer un dossier pour un nouveau wiki qui inclura des composants orientés serveurtiddlywiki monnouveauwiki --serverpour démarrer TiddlyWiki- Positionnez votre navigateur sur l'adresse http://127.0.0.1:8080/
- Essayez d'éditer et de créer de nouveaux tiddlers
L'option -g demande à Node.js d'installer TiddlyWiki globalement. Sans elle, TiddlyWiki ne sera disponible uniquement dans le répertoire où vous l'avez installé.
Utilisation de TiddlyWiki sur Node.js
TiddlyWiki5 peut être utilisé depuis la ligne de commande, dans le but d'effectuer un ensemble d'opérations qui manipulent dossiers TiddlyWiki, fichiers de tiddlers et fichiers TiddlyWiki.
Par exemple, la commande ci-dessous charge les tiddlers d'un fichier TiddlyWiki HTML, et enregistre l'un d'eux dans un fichier HTML statique :
tiddlywiki --verbose --load monwiki.html --rendertiddler LisezMoi ./lisezmoi.htmlL'exécution du programme tiddlywiki depuis la ligne de commande démarre le noyau TiddlyWiki, charge les plugins de base et met en place une structure de wiki vide. Puis les arguments de la ligne de commande sont traités à la suite, de gauche à droite. Les arguments sont séparés par des espaces.
Le premier argument est un chemin optionnel vers le dossier à charger. Si absent, le répertoire courant est utilisé.
Suivent les commandes proprement dites, avec leurs arguments spécifiques, chaque commande étant annoncée par le préfixe --.
tiddlywiki [<cheminverslewiki>] [--<commande> [<arg>[,<arg>]]]Les commandes disponibles sont :
- build
- clearpassword
- editions
- fetch
- help
- import
- init
- listen
- load
- makelibrary
- output
- password
- render
- rendertiddler
- rendertiddlers
- save
- savetiddler
- savetiddlers
- server
- setfield
- unpackplugin
- verbose
- version
Mise à niveau de TiddlyWiki sur Node.js
Si vous avez installé TiddlyWiki sur Node.js de manière standard, vous pouvez le mettre à jour dès qu'une nouvelle version est publiée, à l'aide de la commande suivante :
npm update -g tiddlywikiSur Mac ou Linux, vous devrez ajouter sudo :
sudo npm update -g tiddlywikiVoir aussi
- TiddlyWikiFolders
- MultiTiddlerFileSyntax
- MultiTiddlerFiles
- TiddlerFiles
- Generating Static Sites with TiddlyWiki
- Comment construire un TiddlyWiki5 à partir de tiddlers isolés
- Using TiddlyWiki for GitHub project documentation
- Using a custom path prefix with the client-server edition
- Building TiddlyWikiClassic
- Customising Tiddler File Naming
- Variables d'environment sur Node.js
- Scripts for TiddlyWiki on Node.js
- Serving TW5 from Android
- Working with the TiddlyWiki5 repository
- Internet Information Services
Ce fichier readme a été généré automatiquement par TiddlyWiki
Script Files
The TiddlyWiki5 repository contains several scripts in the bin folder that you can use to automate common tasks, or as a useful starting point for your own scripts. See Scripts for building tiddlywiki.com for details of the scripts used to build and release https://tiddlywiki.com/.
All the scripts expect to be run from the root folder of the repository.
serve: serves tw5.com
./bin/serve.sh -h
./bin/serve.sh [edition dir] [username] [password] [host] [port]Or:
./bin/serve.cmd -h
./bin/serve.cmd [edition dir] [username] [password] [host] [port]This script starts TiddlyWiki5 running as an HTTP server, defaulting to the content from the tw5.com-server edition. By default, the Node.js serves on port 8080. If the optional username parameter is provided, it is used for signing edits. If the password is provided then HTTP basic authentication is used. Run the script with the -h parameter to see online help.
To experiment with this configuration, run the script and then visit http://127.0.0.1:8080 in a browser.
Changes made in the browser propagate to the server over HTTP (use the browser developer console to see these requests). The server then syncs changes to the file system (and logs each change to the screen).
test: build and run tests
This script runs the test edition of TiddlyWiki on the server to perform the server-side tests and to build test.html for running the tests in the browser.
lazy: serves tw5.com with lazily loaded images
./bin/lazy.sh <username> [<password>]Or:
./bin/lazy.cmd <username> [<password>]This script serves the tw5.com-server edition content with LazyLoading applied to images.
Les Tiddlers référents proposent une information sobre d'une façon compréhensible et interconnectée. Le lecteur peut être, aussi bien, un utilisateur moyen ou un expert.
Il existe plusieurs subdivisions :
- Concepts
- Définitions, dont l'ensemble forme un glossaire
- Manuel utilisateur
- Présente les détails techniques des fonctionnalités WikiTexte
- Subdivisions : messages, opérateurs, widgets, etc
- Manuel dévelopeur
- Présente les détails techniques de l'architecture interne de TiddlyWiki
Le matériel de référence est rédigé à la troisième personne, un style formel qui évite de s'adresser au lecteur, pour se focaliser sur la façon dont se comporte TiddlyWiki lui-même. La voix passive est souvent appropriée :
- "Le gabarit spécifié via un tiddler" plutôt que "spécifiez le gabarit via un tiddler"
- "Le widget peut être employé à divers usages" plutôt que "vous pouvez employer le the widget à divers usages"
- Mais "Ce widget offre plusieurs utilisation possibles" est meilleur, car moins alambiqué et plus succinct
Les double négations, les négations contractées et les expressions pouvant conduire à ignorer une négation ou à faire un contresens accidentel par omission doivent être évitées dans les tiddlers référents.
| purpose | filter the input by pattern-matched field |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a field, defaulting to title |
| parameter | X = a regular expression |
| output | those input tiddlers in which field F matches X |
! output | those input tiddlers in which field F does not match X |
Regular expressions are concise strings of characters that denote patterns of text to search for. The format used in TiddlyWiki is fully defined in this Mozilla reference.
The filter syntax makes it impossible to directly specify a regular expression that contains square brackets. The solution is to store the expression in a variable. See the examples.
The parameter X can optionally start or end with a string of flags:
Only the i flag is generally useful: it forces the different between capital and lowercase letters to be ignored.
If X is empty, regexp will match all of the input tiddlers.
These examples make use of the Days of the Week tiddler.
[!is[system]regexp[Wiki]]
Wiki in their title[!is[system]regexp[(?i)Wiki]]
Wiki in their title, ignoring case[!is[system]regexp[Wiki(?i)]]
[regexp[(?i)\.jpe?g$]]
.jpg or .jpeg, ignoring case[regexp:created[^201408]]
The regular expression [0-9]{2} matches two consecutive digits. Because it contains square brackets, the way to use it with the regexp operator is via a variable, as follows:
<$set name="digit-pattern" value="[0-9]{2}">
<<list-links "[regexp:title<digit-pattern>]">>
</$set>Affichera ceci :
- TiddlyWiki European Meetup 2016
- TiddlyWiki European Meetup 2017
- TiddlyWiki extensions for Sublime Text 3 by roma0104
- "デザイン刷新。次の25年を目指すTiddlyWiki" by Moongift
- Base64
- European Meetup 2017
- 5.1.10
- 5.1.11
- 5.1.12
- 5.1.13
- 5.1.14
- 5.1.15
- 5.1.16
- 5.1.17
- 5.1.18
- 5.1.19
- 5.0.0-alpha.11
- 5.0.0-alpha.12
- 5.0.0-alpha.13
- 5.0.0-alpha.14
- 5.0.0-alpha.15
- 5.0.0-alpha.16
- 5.0.0-alpha.17
- Notes for upgrading to 5.0.11-beta
- 5.0.10-beta
- 5.0.11-beta
- 5.0.12-beta
- 5.0.13-beta
- 5.0.14-beta
- 5.0.15-beta
- 5.0.16-beta
- 5.0.17-beta
- 5.0.18-beta
- $:/state/tab/sidebar--1835078512
This release is the culmination of a large scale refactoring of the widget mechanism of TiddlyWiki5. There are several changes to be aware of if upgrading from earlier versions:
- The following widgets have been removed:
<$setstyle>- use<div style=<<macroName Param>>>instead<$video>- will return in a later release<$datauri>- use the<<makedatauri>>built-in macro instead<$error>- may return in a later release<$import>- use the BrowseWidget, DropzoneWidget and NavigatorWidget instead<$info>- use the<<changecount>>built-in macro instead<$version>- use the<<version>>built-in macro instead
- The following widgets have had significant changes:
- EditWidget
- ListWidget - the list widget itself no longer generates HTML nodes, so you'll often need to wrap the template in a
<div>or a<span>to be able to style the content - ViewWidget - has several changes:
<$view format="link"/>is no longer available; use an explicit<$link>widget instead<$view format="link"/>is no longer available; use the TranscludeWidget instead
- The following new widgets have been added:
- Widget attribute names have been made more consistent. In particular,
tiddleris used to reference a tiddler by title, nottitle - It is no longer possible to import the macro definitions within another tiddler by transcluding that tiddler
- The
bodyelement now has the classtw-body, which will need to be specified in any overrides- This was done due to the new support for HTML foreign objects, which makes it possible to have multiple
<body>elements in a document
- This was done due to the new support for HTML foreign objects, which makes it possible to have multiple
See GitHub for detailed change history of this release
This minor release just contains fixes for the syncer and related adaptor modules for the TiddlyWeb edition and for TiddlyWiki5's integrated server.
See GitHub for detailed change history of this release
This release has several bug fixes:
- Fixes to DaveGifford's themes blanca, blue and rocker
- Fix an issue with the
<$edit-text>widget - Documentation updates
- Improved deployment scripts
- Made the modifier field in the subtitle be a link
- Styling improvements for the CodeMirror plugin
- Improved the ViewWidget so that it falls back to displaying its content if the field/property is missing or empty
- Extend use of the built-in
<<tabs>>macro to the tiddler info panel, the control panel and the sidebar- This means that you can add new tabs by creating tiddlers with these tags, and optionally a
captionfield for the text of the tab:- $:/tags/TiddlerInfo for tiddler info panel tabs
- $:/tags/ControlPanel for control panel tabs
- $:/tags/SideBar for sidebar tabs
- $:/tags/MoreSideBar for tabs in the "more" sidebar
- Change the order of tabs by adjusting the
listfield of the corresponding tag tiddler
- This means that you can add new tabs by creating tiddlers with these tags, and optionally a
See GitHub for detailed change history of this release
This release has several bug fixes:
- Improved the layout of the control panel
- Fixed problem with using the CheckboxWidget to apply tags to tiddlers that don't have any existing tags
- Fixed problem with default password for the PasswordWidget being the string "null"
See GitHub for detailed change history of this release
New Features
- Added a dropdown to the edit template for setting the tiddler type
- A saver module for Microsoft Internet Explorer version 10 and above. Clicking save in the sidebar causes the browser to pull up a bar at the bottom of the window where you can click save. You then get a new copy of your wiki in the downloads folder.
- Support for new
tw-close-other-tiddlersmessage (eg, ) - For http://five.tiddlywiki.com, add a tiddler info tab with a link to the static representation of the tiddler
- Make more UI elements extensible via system tags:
- $:/tags/ViewToolbar for the view mode tiddler toolbar
- $:/tags/EditTemplate for the edit template
- $:/tags/EditToolbar for the edit mode tiddler toolbar
- $:/tags/PageControls for the page control tools in the sidebar
Improvements
- Rename the
<$setvariable>to<$set><$setvariable>will temporarily remain as a synonym for<$set>for the next few releases
- Improve the popup mechanism so that the tiddler info panel doesn't close so easily
- Various improvements for working with TiddlyWeb, including:
- Updated control panel
Bug fixes
- Fixed bug when creating a tiddler title starting or ending with a space
- Fixed behaviour of tags editor dropdown when search box is empty
- Fixed problem with interpretation of
fieldsandindexattributes of the TranscludeWidget - Fixed the module type names in the internal tab of the control panel
- Improved styling for embedded PDFs
- Fixed bug with second being omitted from serialised date formats
Contributors to this release include @jermolene and @grayeul.
See GitHub for detailed change history of this release
New Features and Improvements
- Improved appearance of tags editor
- Improved generation of qualified tiddler titles for state storage
- Instead of
$:/state/tab/sidebar-{$:/core/ui/SideBar|$:/core/ui/SideBar||}{$:/core/ui/PageTemplate|$:/core/ui/PageTemplate||}one gets$:/state/tab/sidebar-{1743827719}
- Instead of
- Significant updates to the structure and content of the user documentation
- Added a new plugin for displaying corner ribbons; currently used for a version banner on tw5.com
- Split Snow White theme into a base Vanilla theme with all the basic formatting, leaving the decorative bits to Snow White
- Existing TiddlyWikiFolders will need updating to include Vanilla as an additional theme
- The page building blocks are now driven by the system tag
$:/tags/PageTemplate- $:/TopSideBar and $:/LeftSideBar are no longer specially treated; use the new tag instead
- Fixed problem that prevented tag configured items from shadow tiddlers interleaving with items from ordinary tiddlers
- Refactored control panel to add Saving tab that includes TiddlySpot options
- Improved notifications when saving to TiddlySpot
- Added backup URL to TiddlySpot control panel tab
- Extended the ServerCommand to add primitive support for basic authentication when running under Node.js
Bug fixes
- Fixed problem with displaying tiddler titles that contain WikiText syntax
- No longer crashes when encountering an error in a filter string
- Fixed a crash when dragging and dropping tiddlers within TiddlyWiki5
- No longer update the modified date for imported tiddlers
- Automatically forces new field names to be lower case
Internal changes
- Added Windows-compatible build scripts
- Changes to the SavingMechanism to allow the tiddlers that are saved to be selected
- This enables the wiki at http://five.tiddlywiki.com/index.html to generate an empty wiki
- The main HTML file template used for saving TiddlyWiki5 documents has changed from
$:/core/templates/tiddlywiki5.template.htmlto$:/core/save/all - Moved tw5.com's Google Analytics integration into a proper plugin
Contributors to this release include @jermolene, @asampal and @pmario.
See GitHub for detailed change history of this release
Bug fixes
- Fixes a small but important bug that prevented downloading an empty wiki with alpha.16
See GitHub for detailed change history of this release
Improvements
- Changes to the importing process to enable a smoother Upgrading process
- Ignores attempts to import plugins that are older than currently installed plugins
- System tiddlers are now imported as usual
- If
$:/themeisn't defined or refers to a missing tiddler, then fallback through Snow White to Vanilla. This means thatempty.htmlnow defaults to Snow White - Added support for Block Quotes in WikiText
- Contributed by StephanHradek (@Skeeve on GitHub)
Bug fixes
- Fixed bug that was preventing
$:/tags/PageControlstiddlers from being reordered
Internal changes
- Changed the TiddlyWiki5 Versioning policy
- Beta releases will be
5.0.x-betaand the final release will be5.1.x
- Beta releases will be
See GitHub for detailed change history of this release
Highlights
- Added new syntax for Images in WikiText and a new ImageWidget
- Added support for a SafeMode that disables customisations
Documentation Improvements
- Added DateFormat documentation
Usability Improvements
- Refactor sorting to respect accented characters
- Support embedded images in Markdown tiddlers
- Refactored sidebar hiding action so that the story river border is maintained
Hackability Improvements
Bug Fixes
- Added support for saving changes on Windows network drives
- Refactored configuration processing so that ordinary tiddlers are processed after shadow tiddlers. This resolves an issue whereby user stylesheets were being overridden by shadow stylesheets
- Fixed issue with offline snapshot of server edition erroneously including shadow tiddlers
- Fixed problem with corrupted upgrades from 5.0.x-prerelease to 5.0.x-beta
- Fixed bug with
[untagged[]]filter operator - Fixed incorrect background colour for tag pills in the sidebar
- Fixed issues with null fields under TiddlyWeb
- Fixed problem with hamburger overlapping scrollbars
See GitHub for detailed change history of this release
Incompatible Changes
See Notes for upgrading to 5.0.11-beta for more details of these changes:
- The default output location for command line operations has changed to the
/outputfolder within TiddlyWikiFolders (it used to be current directory) - Note that the shadow tiddler $:/core/ui/PageMacros has changed with this release. If you've made modifications to it you should copy your modifications to a new tiddler, delete $:/core/ui/PageMacros, perform the upgrade and then manually update the new copy of $:/core/ui/PageMacros
Documentation Improvements
- Added more warnings about taking care to backup your data
Usability Improvements
- Many performance optimisations, particularly for filter operations
- Added support for PermaLinks and browser back and forward buttons
- Added support for WikiLinks in Markdown via
[link text](#TiddlerTitle) - Added support for explicit external Linking in WikiText (eg
[ext[tooltip|url]]) - Replaced hamburger menu icon with double chevron icon
- Enhance plain text parsing to use the CodeBlockWidget, and hence use syntax highlighting if the plugin is installed. This gives us syntax highlighting for JavaScript shadow tiddlers, amongst other things
- Improvements to the German, French, Italian, Japanese and Chinese translations
- Removed WikiText tiddlers from the sidebar "Types" tab
- Added various warnings when editing shadow tiddlers
- Allow digits in field names
- Added warning banner and when attempting to edit binary tiddlers
- Added automatic refreshing of the browser window title from $:/core/wiki/title
Hackability Improvements
- Improved vertical layouts of
tabsmacro - Added "standard" tab to advanced search
- Added new filter operators
beforeandafter - Added new
getoperator - Added BuildCommand, OutputCommand and ClearPasswordCommand
- Added new extensible StartupMechanism for orchestrating startup tasks
- Updated to new version of CodeMirror
- Added https://github.com/Jermolene/TiddlyWiki5NodeWebkit, a demo of using TiddlyWiki as a library in a node-webkit application
- Extended
.tidTiddlerFiles to allow single line text fields - Renamed
$:/ShowEditPreviewto$:/state/showeditpreview
Bug Fixes
- Fixed issue with hovering of the topbar icons in Firefox
- Fixed problem with dragging and dropping within a text edit control
Contributors
I (@Jermolene) would like to thank the contributors to this release who have generously given their time to helping improve TiddlyWiki:
@BramChen, @mwfogleman, @nameanyone, @natecain, @pekopeko1, @pmario, @sukima, @xcazin.
See GitHub for detailed change history of this release
This is an emergency release that fixes a single significant bug with shadow tiddler handling in 5.0.11. See the discussion thread for more details.
See GitHub for detailed change history of this release
Accessibility Improvements
This release includes a number of features designed to improve the experience of TiddlyWiki with a screen reader. Particular thanks to @domasofan for his feedback
- Added label and title for show/hide sidebar buttons
- Added label and title for advanced search link
- Added label and title for close buttons in "Open" sidebar tab
- Added aria-label support to the LinkWidget
- Switched to H1 tags for the page title and H2 tags for tiddler titles
- Added label and title for tiddler and page toolbar buttons
Usability Improvements
- Added support for global Macros in WikiText via the new ImportVariablesWidget
- Added new SelectWidget
- Improved behaviour of
text/htmltiddlers so that they are displayed within an HTML iframe element - Added group headings to the content type dropdown in edit mode
- Improved advanced navigation settings in $:/ControlPanel to use radio buttons
- Improved (and here) behaviour of PermaLinks so that now https://tiddlywiki.com/#HelloThere just opens the single specified tiddler
- Added support for triple-quoted multi-line attributes with macros, widgets and HTML elements
- Added TableOfContents tab for tw5.com edition
Hackability Improvements
- Restored escape as a shortcut to abandon edits
- Added support for ExternalImages that are referenced by URI and not stored in the TiddlyWiki HTML file
- Added new SetFieldCommand
- Added new SaveTiddlersCommand
- Added support for system tag $:/tags/RawMarkup
- Added editor type mappings to control panel advanced tab
- Refactored CodeMirror (https://tiddlywiki.com/codemirrordemo.html) plugin for simpler configuration
- Added support for Environment Variables on Node.js
- Extended ServerCommand to allow a path prefix
- Extended the
listedoperator to use any list field
Bug Fixes
- Fixed here and here the problem with state tiddlers being inadvertently saved
- Fixed bug with TextWidget not refreshing correctly
- Fixed problem with vertical tabs in Safari
- Fixed issue with images in Markdown
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Major Changes
Improved Control Panel Plugins Tab
The Plugins tab of the control panel has been improved with the addition of documentation tabs that plugins can use to show documentation. There is also a larger draggable area for dragging tiddlers across to other wikis.
Configurable Button Toolbars
The page toolbar and the tiddler toolbars can now be configured with several new buttons - see the control panel under the Appearance and Toolbars tabs.
The sidebar tools tab now shows all the available page controls, allowing them to be invoked or checked to appear in the toolbar. The tiddler info area now includes a tools tab that includes buttons for all the tiddler actions.
Upgrade Mechanism
There are two components:
- A more flexible ImportMechanism that:
- Presents incoming tiddlers as a pending import list that allows the user to inspect them and, if necessary, explicitly deselect them from the actual import
- Provides UpgraderModules with an opportunity to process each incoming tiddler
- The plugin upgrader module handles version checking of plugins and upgrading them from a special UpgradeLibrary plugin tiddler
- The system upgrader module is responsible for suppressing the importing of certain system tiddlers (currently $:/StoryList and $:/HistoryList)
- The themetweak upgrader module handles migrating theme tweaks from their pre-5.0.14-beta format (see below)
- An UpgradePlugin and associated edition that provides a custom, single-purpose user interface for upgrading standalone TiddlyWiki files - see https://tiddlywiki.com/upgrade.html
Improvements to CamelCase Recognition
TiddlyWiki now takes a much more conservative approach to recognising CamelCase terms that should be automatically linked. Previously, the dash and underscore were treated as lower case letters, leading to a number of false positives. See the GitHub bug #337 for details.
Automatic Permalinking Off by Default
With previous beta releases of TiddlyWiki the browser address bar is automatically updated so that it dynamically reflects the tiddlers that are currently open. This makes it easier to get a permalink for copying and pasting elsewhere, but it leads to much confusion for casual users who don't always understand why unexpected tiddlers are being displayed after they have refreshed the page in the browser.
For 5.0.14-beta, the setting has been changed. Visit control panel Advanced/Settings to switch the setting back to "Include the target tiddler and the current story sequence".
Usability Improvements
- Added previews to the icon dropdown in the tag manager
- Added an indication of unsaved changes by changing the colour of the save changes button
- Split the wikitext emphasis parsers into separate modules so that they can be independently controlled with the
\rulespragma - Refactored (and here) ReleaseHistory to place the releases into vertical tabs
- Stopped saving $:/HistoryList, thus avoiding it uncontrollably increasing in size
- Improved (and here) print stylesheet to remove page background
- Updated display of plugin tiddlers so that their constituent tiddlers are shown, rather than the raw JSON
- Moved the functionality of the fullscreen plugin into the core
Hackability Improvements
- Extended TiddlerWidget to add a CSS class corresponding to each tag present on displayed tiddlers
- Added support for hiding specified fields in the tiddler editor
- Added support for variable operands in filters (see Filter Parameter)
- Added support for widget messages tw-permalink and tw-permaview
- Added browser sniffing plugin so that tiddlywiki.com can present the correct browser-specific documentation
- Added a configuration option for specifying the default location for saving new tiddlers in the client-server configuration
- Added support for the InfoMechanism
- Extended CheckboxWidget to allow it to toggle fields as well as tags
- Refactored control panel theme tweaks to be stored in individual tiddlers
- Extend the
tabsmacro to allow tabs to be templated - Added (and here) SystemTags support for inserting content above and below the story river
- Added support for transcluding plugin subtiddlers with the TranscludeWidget
- Added (and here) support for importing from
*.htmand*.htafiles as well as the existing support for*.htmlfiles - Extended the "sticky titles" theme so that it works when tiddlers are in edit mode
Bug Fixes
- Fixed bug with execution order of BuildCommand targets
- Fixed bug with missing hover colours for external links
- Fixed problem with refreshing modal dialogues
- Fixed issue with cookies disabled on Firefox
- Relax the requirement for a newline immediately the closing
\endof a macro definition
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Usability Improvements
- Simplified shadow default tiddlers
- Added the ability to disable plugins (see PluginMechanism) with a user interface in control panel
- Added page control button for invoking the tag manager
- Simplified downloading an offline copy of a client-server wiki
- Blocked temporary state tiddlers from import/upgrade
Hackability Improvements
- Added a banner to the edit template encouraging improvements to the documentation
- Refactored
saver-handler.jsout ofsyncer.js - Added Table-of-Contents Macros
- Simplified startup module organisation (see Startup Modules.svg)
- Changed the overlay text for the DropzoneWidget to make it translateable
- Introduced a new refresh button and reverted home button behaviour
- Added alt attribute to the ImageWidget
Bug Fixes
- Fixed problem with building TiddlyWiki under Windows
- Fixed unclickable download ink in upgrade wizard
- Fixed missing language flag in empty.html
- Fixed problem with switching the type of a tiddler between the bitmap and text editor
- Fixed foreground colour for tag pills in the sidebar
- Fixed problem with github source links for tiddlywiki.com not working for titles containing colons
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Incompatible Changes
5.0.16-beta brings more incompatible changes than any previous release. These changes are likely to break almost all plugins written for previous releases of TiddlyWiki 5, and will break many customisations.
- Changed all CSS class prefixes from
tw-totc-(egtw-tiddler-framehas becometc-tiddler-frame; missing prefixes have also been added, sobtn-invisiblehas becometc-btn-invisible) - Changed all message prefixes from
tw-totm-(egtw-close-tiddlerhas becometm-close-tiddler) - Changed all variable prefixes from
tw-totv-(egtw-config-toolbar-iconshas becometv-config-toolbar-icons) - Changed prefix/removeprefix filter operators to be case-sensitive
Compatibility with TiddlyWikiClassic
This release includes a preliminary version of a new plugin that provides compatibility with content created for TiddlyWikiClassic:
https://tiddlywiki.com/classicparserdemo.html
Subsequent releases will include end-user documentation with step-by-step instructions for migrating content.
Many thanks to @buggyj for his work on this plugin.
Usability Improvements
- Amended behaviour of the tm-browser-refresh message so that it no longer clears the location hash
- Hide toolbar buttons from static renderings
Hackability Improvements
- Extend the
alloperator to be able to select all the source tiddlers - Fixed problem with single line macro definitions incorrectly including whitespace in the value. (For example,
\define mymacro() yeswould set the macro value to " yes", with a leading space) - Extend Table-of-Contents Macros use the caption field if present
- Configurability for the default tab shown in the tiddler info panel (see Configuring the default TiddlerInfo tab)
- Added
suffixandremovesuffixoperators
Bug Fixes
- Reverted incorrect refreshing of the tiddler widget
- Fixed indentation of selective expandable Table-of-Contents Macros
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Highlights
This release includes major improvements from @giffmex to the welcome and tutorial documentation, and new development docs incorporating the work of @cheigele and @cjrk.
Incompatible Changes
Change System Tag $:/tags/stylesheet with $:/tags/Stylesheet
The issue is that the capitalisation of $:/tags/stylesheet is not consistent with other system tags. This release adds support for $:/tags/Stylesheet, and adds a deprecation warning if $:/tags/stylesheet is used. Support for $:/tags/stylesheet will be removed before the beta.
- Added support for
$:/tags/Stylesheetand a deprecation warning when$:/tags/stylesheetis used
Change ButtonWidget title attribute to tooltip
The use of the title attribute in the ButtonWidget was not consistent with the tooltip attribute used by the ImageWidget and LinkWidget. This release adds support for the tooltip attribute to the ButtonWidget alongside the existing support for the title attribute, but with a deprecation warning.
- Added
tooltipattribute to ButtonWidget
Removing Support for RegExp Filter Operands
As discussed in the associated ticket, the support for regular expression filter operands is incomplete and inconsistent. The plan is to remove support for this feature in the next release. A new filter operator has been provided to replace it, along with the addition of a deprecation warning that is displayed whenever regular expression filter operators are used.
Repository Reorganisation
The goal is to make the TiddlyWiki repository easier to comprehend for newcomers.
- Moved scripts into a separate
binfolder
Usability Improvements
- Reorganised the control panel to make it more logical and usable
Hackability Improvements
- Moved developer documentation to https://tiddlywiki.com/dev
- Improvements (and here) to
serve.sh/serve.cmdscripts - Disable plugins when in SafeMode
- Added new
timelinemacro - Added new
dumpvariablesmacro - Extended Table-of-Contents Macros so that individual links can be disabled
- Removed (and here) unnecessary
<p>tag from edit tags and types dropdowns - Added multiple attribute to the BrowseWidget
- Extended view template to hide bodies of tiddlers with field hide-body set to yes
Bug Fixes
- Fixed problem with draft tiddlers not counting as dirty
- Fixed problem with keyboard shortcuts introduced in 5.0.16-beta
- Fixed problem with stylesheets being parsed in inline mode
- Fixed bug with selective expandable Table-of-Contents Macros
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a minor release prior to the full release of TiddlyWiki on September 20th. The documentation has been cleaned up and improved (with more improvements to come).
File Layout of tiddlywiki.com
The layout of files on tiddlywiki.com has been adjusted to make it more logical. See the ticket for a discussion. You can see the source files that make up tiddlywiki.com at https://github.com/Jermolene/jermolene.github.com
Hackability Improvements
- Added first iteration of a
list-linksmacro (further improvements are planned) - Added support for importing
.markdownand.mdfiles - Extended
timelinemacro to support a subfilter
Bug Fixes
- Fixed problem with digits being classified as lower case letters for wiki link matching
- Fixed crash when sorting missing tiddlers by fields other than title
- Fixed problem with handling
.jpegfile extensions - Fixed problem with RadioWidget and missing tiddlers
- Fixed problem with dragging a partially selected link
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Improvements
- Added support for Hard Linebreaks in WikiText
- Added a new RadioWidget, contributed by StephanHradek (@Skeeve on GitHub)
- Two new savers for InternetExplorer, both contributed by DavidJade (@davidjade on GitHub)
- tiddlyie for saving with TiddlyIE, an equivalent of TiddlyFox for InternetExplorer
- fsosaver that can save changes directly with InternetExplorer but requires the HTML file to be renamed
*.hta
Bug fixes
- Fixed problem deleting tiddlers under the filesystemadaptor
- Fixed problem with transcluding fields containing lists or dates (eg,
{{!!tags}}) - Fixed problem with re-ordering page control tiddlers (ie tiddlers tagged
$:/tags/PageControls) - Update template used for deploying to TiddlyWeb
- Fixed problem with tiddler deletions via the file system adaptor
Internal changes
- Allowed variable number of arguments to JavaScript Macros
- Contributed by StephanHradek (@Skeeve on GitHub)
- Changed the format of plugin tiddlers to remove duplicated information (see the PluginMechanism)
See GitHub for detailed change history of this release
This release includes minor bug fixes and documentation updates.
See GitHub for detailed change history of this release
Improvements
- Switched to using an HTML5 placeholder for the default text of a new tiddler
- Refactored stylesheet handling so that theme tweaks are now applied immediately, and some ordering issues have been resolved
- Several improvements for running TiddlyWiki on Node.js:
- The
tiddlywiki.infofile in the root of wiki folder file is now optional, falling back to a default configuration suitable for serverside use (commit) - The file system plugin now automatically creates the
tiddlerssubfolder in the wiki folder
- The
- Added favicon.ico support
- Added SaveTiddlerCommand
Bug Fixes
- Fixed problem with tiddlers sometimes wrongly opening at the top of the story (commit)
- Fixed problem with refreshing RadioWidget
- Fixed problem with the dragger image being visible in some circumstances
- Fixed drag and drop support on InternetExplorer, contributed by DavidJade (@davidjade on GitHub)
- Fixed crash on modifying page template (commit)
- Updated fullscreen plugin to latest version of the API (commit)
- Improved handling of double square brackets within tags (thanks to StephanHradek)
This release includes minor bug fixes and documentation updates.
See GitHub for detailed change history of this release
Improvements
- Added support for Setting a favicon
Bug Fixes
- Fixed problem with modal wizard positioning on narrow screens
- Fix problem with static content being included in empty.html when downloaded from the full wiki
- Improved performance of tiddler import with large tiddlers on Firefox
See GitHub for detailed change history of this release
Improvements
- Added support for numeric sorting to TiddlerFilters (thanks to StephanHradek)
- Extended Tables in WikiText to allow for vertical alignment of cells (thanks to StephanHradek)
- Added experimental support for running TiddlyWiki on node-webkit
- Added an $:/AdvancedSearch
- Added support for specifying hostname for the ServerCommand
- Added a first pass at generating an all-in-one static HTML representation of a wiki, complete with internal anchor links for wiki links
- Hide encryption features when running on the server
- Added double backticks as an alternative for delimitting inline code (thanks to StephanHradek)
Bug Fixes
- Fixed import browse button
- Fixed crash when attempting full screen mode on browsers that don't support it
- Fixed requirement for a newline immediately after a horizontal rule, table or typed block (thanks to StephanHradek)
- Fixed problem with placeholder attibute on InternetExplorer (thanks to DavidJade)
See GitHub for detailed change history of this release
Incompatible Changes
These are changes that might affect users upgrading from previous betas.
- The node-webkit saver has been moved into a plugin - $:/plugins/tiddlywiki/nodewebkitsaver. The plugin is only needed when embedding a single TiddlyWiki in node-webkit and is not required for TiddlyDesktop, which as of v.0.0.2 uses the existing TiddlyFox saver.
Documentation updates
- A new video tutorial: TiddlyWiki on Firefox for Android Video
- A first pass at TiddlyWiki Coding Style Guidelines
- Added an explanation of TemplateTiddlers
- Added documentation for saving on a custom PHP server
- Added documentation for TextWidget
- Summary of the approach for Naming of System Tiddlers
Improvements
- Added support for importing encrypted TiddlyWiki documents
- Added several new filter operators, including reverse, first, last, butlast, rest, nth
- Extend list filter operator to allow other fields to be used via a TextReference
- Added shortcut in $:/ControlPanel Basics tab for setting $:/DefaultTiddlers to retain tiddler story ordering
- Added emacs and vim keymapping support to the CodeMirror plugin, (thanks to João Bolila, @jbolila on GitHub)
- Added the highlight.js syntax highlighting plugin: https://tiddlywiki.com/highlightdemo.html (thanks to João Bolila, @jbolila on GitHub)
- Added the first export option to the Tools tab of the control panel
- Added an ellipsis for advanced search next to the search box in the sidebar
- Adjusted the password dialogue to make it narrower for smaller screens
- Adjusted the display of tiddler dictionaries to make them display as plain text
Bug Fixes
- Fixed problem with default format of ViewWidget substituting seconds for minutes in displayed times
- Fixed problem that was causing several animations to fail in Safari
- Fixed problem with unclickable sidebar under the Centralised theme
- Fixed problem with non-system tiddlers showing up in system tiddler advanced search
- Fixed problem with notifications not always disappearing in Firefox
- Fixed problem with wiki folders including wiki files with tiddlers that do not have a title
- Fixed problem with ServerCommand logging "Serving on undefined:8080"
See GitHub for detailed change history of this release
Incompatible Changes
See Notes for upgrading to 5.0.8-beta for more details of these changes:
- Changed rules for parsing content of HTML elements
- Switched SiteTitle and SiteSubtitle to $:/SiteTitle and $:/SiteSubtitle
- Changes to commands used with TiddlyWiki on Node.js
- Changes to naming of some editions
- Notably clientserver has changed to server
Documentation Improvements
- Improved documentation for TiddlerFilters, including a notation of the TiddlerFilter Formal Grammar contributed by @Tikkoneus
- Improved documentation for WidgetMessages
- Tiddlers on tiddlywiki.com now have a link to the original source on GitHub for pull requests (see the "Sources" tab of the tiddler info panel)
Usability Improvements
- Added automatic saving on editing a tiddler and a warning when attempting to close the window with unsaved changes
- Added confirmation dialogue when deleting tiddlers
- Add support for switchable (and editable) ColourPalettes
- Added TranslationMechanism and translations for:
- Deutsch (Österreich and Deutschland) by @pmario
- Français (France) by @xcazin
- Chinese (Simplified and Traditional) by @BramChen
- Add error alerts when syncing to a server
- Rejigged $:/ControlPanel to use nested tabs
- Added $:/TagManager for easy management of tags
- Added experimental KeyboardWidget, including support for ctrl-enter (or cmd-enter) to finish editing a tiddler
- Added number of tags to control panel Basics tab
- Enhanced link handling so that control/command clicking a link opens the target tiddler without navigating to it
- Importing tiddlers via drag and drop no longer opens all the tiddlers
Scalability Improvements
- Added support for LazyLoading of images
- Extended RevealWidget to allow control over content retention
Hackability Improvements
- Added HelpCommand and InitCommand for TiddlyWiki on Node.js
- Extended ButtonWidget to allow navigating to a tiddler
- Added experimental support for building plugins in the browser: How to create plugins in the browser
- Extend the TranscludeWidget to display its content as a fallback if the tiddler or field is missing
- Add logging and AlertMechanism
- Added a Filter tab to advanced search
- Add indexes filter operator
- Control over line width and colour for EditBitmapWidget
- Add support for
.multidsMultiTiddlerFiles - Extend ViewWidget so that it works with indexes
- Added support for Tank, a new service built on TiddlyWeb: https://tank.peermore.com
- Extend relative dates to work in the future
Bug Fixes
- Fixed problem with pasting items into the browser
- Fixed problem with colour pickers not showing correct colour in Chrome
- Fixed problem with tag pills not working inside table cells
- Fixed problem in client server configuration with % in tiddler titles
- Fixed problem with not using placeholder text when editing missing tiddlers
- Fixed problem with test data in certain time zones
- Fixed problem with non-breaking space characters being converted into '@' symbols
- Fixed problem with highlighting plugin only working in the browser
- Fixed crash when wiki/themes folder contains files that are not themes
See GitHub for detailed change history of this release
Highlights
- Improved layout, including a hamburger icon for dismissing the sidebar and expanding the story river to fill the space
- Added new Seamless theme
- New Filter tab in $:/AdvancedSearch
- Initial implementation of CecilyView
- Overhaul of inconsistencies in TiddlerFilters (see Changes to filters in 5.0.9-beta)
- New translations for Italian and Japanese
- Performance improvements, particularly during editing
Documentation Improvements
- Improved and reorganised documentation for TiddlerFilters
- Demo of Making curved text with SVG
- Community links are now broken up into individual tiddlers
- Added overview diagram of TiddlyWiki Architecture
- Added documentation from buggyj: Developing plugins using Node.js and GitHub
Usability Improvements
- Made the dropdown arrow icon skinnier
- Added validation of legal characters for fieldnames
- Added blacklisting of unsafe HTML elements and attributes
- Added a warning indicator to tiddlers in TiddlyWikiClassic format
- Add tiddler info Advanced panel with information about plugins and shadow tiddlers
- Improved layout of $:/ControlPanel Plugins tab
- Enhance viewing of system tiddlers by fading down the
$:/prefix - Extend $:/TagManager to allow icons to be assigned to tags
- Added support for
list-beforeandlist-afterfields for controlling tag ordering (see TiddlerTags for details) - Added request for confirmation before abandoning edits to a tiddler
Hackability Improvements
- Updated Transclusion in WikiText syntax to allow translusion of a template without affecting the current tiddler
- Added
sourceURLhandling toeval()so that tiddler modules can be properly debugged in Chrome - New ScrollableWidget giving better control over scrollable regions
- Added new CSS class
tw-site-titlefor the site title - Disable the TiddlyWeb sync adaptor unless the wiki is loaded over HTTP
- Added a high resolution timer mechanism and a performance measurement mechanism
- Added a basic CSV parser
- Several measures to enforce the TiddlyWiki programming model:
- Extend the ButtonWidget to be able to set text references
- Add a class to tiddler frames in view mode
- Added support for WidgetMessage: tw-home
- Hidden system tags from the sidebar Tags tab
- Allow pasting and import of HTML content
- Add support for a tooltip on the LinkWidget
Bug Fixes
See GitHub for detailed change history of this release
This is the first full release of TiddlyWiki. Documentation updates made up the bulk of the changes since the previous 5.0.18-beta release.
Hackability Improvements
- Removed curly braces from qualified identifiers
Bug Fixes
- Fixed problem with Markdown Maruku mode metadata
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a minor bug fix release to improve the documentation and correct some issues with the first full release of TiddlyWiki.
Incompatible Changes
Certain features that were deprecated in Release 5.0.17-beta have now been removed:
- Removed deprecated
titleattribute on the ButtonWidget - Removed support for deprecated
$:/tags/stylesheetsystem tag
Note that the next release will also remove support for regular expression filter operands, which was also deprecated in 5.0.17-beta.
Hackability Improvements
- Added first implementation of the KaTeX Plugin for mathematical typesetting
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Major Improvements
Performance Optimisations
This release includes several low-level performance optimisations that should improve speed and responsiveness in many common operations.
- Caching the results of parsing a tiddler
- Loop optimisations
- Tiddler iteration optimisations
- State qualifier generation
- Caching data tiddlers
- Removed expensive visual effects
There is a new setting in the control panel to enable performance instrumentation, making it much easier to measure and improve performance issues.
New Editions
Three new editions of TiddlyWiki are included in this release. These can be used as starting points for creating your own wiki for several purposes:
- The Résumé Builder Edition by @inmysocks is a custom edition to guide you through the process of using TiddlyWiki to create a good looking résumé (or curriculum vitæ)
- The Blog Edition provides tools for using TiddlyWiki under Node.js to create a static HTML blog that can be published on GitHub pages (or similar)
- The Text-Slicer Edition is a custom edition with tools to help advanced users slice longer texts up into individual tiddlers.
External Text Tiddlers
Limited support for tiddlers stored in external .tid files:
- standalone TiddlyWiki HTML files with external text tiddlers can be built under Node.js
- wikis with external text tiddlers can be worked with in the browser, automatically lazily loading the content of external text tiddlers when it is first referenced
- saving changes in the browser doesn't work as expected: if edited, the external text tiddler is replaced with an ordinary tiddler
- lazy loading of external text tiddlers doesn't work in Chrome when viewing the TiddlyWiki HTML file on a file: URI; it works OK in Firefox
- lazy loading works on an HTTP URI on all browsers as long as the target file is either stored on the same domain or is served by a server that supports CORS
See Alice in Wonderland for an example. Try opening it without a network connection.
New "Tight" Theme
A new theme called "Tight" uses reduced padding, margins and font-sizes to pack as much text as possible:
Other Improvements
Translation Improvements
- Added Swedish translation by @Superdos
- Added Korean (Korean Republic) translation by @araname
- Improved Catalan, Chinese, Danish, Dutch, French, German, Italian, Russian and Spanish translations
Usability Improvements
- Enhanced the tiddler editor to accept new fields and tags when clicking confirm, without having to click "Add tag" or "Add field"
- Added new fold and fold others buttons to the tiddler toolbar to temporarily hide the body of a tiddler, and also added new fold all and unfold all page buttons
- Added ability to disable individual WikiText parser rules (see the Advanced tab of $:/ControlPanel). Also added a simple setting for disabling automatic linking of CamelCase words
- Extended support for automatically linked system tiddler titles to include digits and underscore
- Added warning when trying to use plugins designed for TiddlyWiki Classic
- Upgraded to version v8.8.0 of highlight.js for the Highlight Plugin
- Removed the need to manually confirm deleting alerts
- Added optional tooltips to tabs Macro
Hackability Improvements
- Updated to KaTeX v0.5.1, with several new features
- Added
publishFilterto default save template - Allow delete button to be used in the tiddler view-mode toolbar
- Added a new hidden setting for keyboard shortcuts
- Update ActionSetFieldWidget to allow timestamp to be preserved
- Added option to suppress navigation for edit/cancel/save
- Enhance SaveTiddlersCommand with do not delete option
- Enhance RenderTiddlerCommand with template option
- Extend tm-open-window to pass variables
- Added new utility method
$tw.utils.tagToCssSelector(tagName)for converting tag titles into a form suitable for matching thetc-tagged-*classes generated by TiddlyWiki - Added support for tiddlers containing mp4 videos
- Extended the ActionSetFieldWidget to enable it to be used to delete a field or indexed property
- Made the tw5.com documentation available as a plugin and an edition, simplifying some scenarios for re-using it
- Improved rendering of "More" sidebar tab gradients in the "Snow White" theme
- Added option in control panel to enable the display of detailed performance instrumentation in the browser developer console
- Added a LazyLoading template for all non-system tiddlers
- Improved handling of TiddlerLinks in Markdown tiddlers
- Extended FieldManglerWidget to create the target tiddler if it does not exist
- Extended KeyboardWidget to trigger ActionWidgets
- Extended SelectWidget to support multiple selections
- Added new days Operator
- Added official plugin wrappers for the JavaScript libraries async.js and JSZip
- Added new ActionListopsWidget
- Added rows attribute to EditTextWidget
Bug Fixes
- Fixed problem introduced in 5.1.9 with processing
tiddlywiki.infofiles - Fixed problem with invisible icons in $:/AdvancedSearch
- Improved check for required plugins in ServerCommand
- Fixed problem with queueing change events for deleting non-existent tiddlers
- Ensure EditTextWidget fixes height even if refresh isn't required
- Fixed the gradient on the sidebar tabs divider
- Fixed problem with tiddler titles such as
$:/templates/somethingbeing erroneously classed as$:/temptiddlers, and so excluded from syncing - Switched to absolute date format in tiddler subtitles
Node.js Improvements
- Fixed problem with the filesystem adaptor saving new image files as base64-encoded .tid files instead of as native binary files with an accompanying
.metafile - Extended
tiddlywiki.filessupport in TiddlyWikiFolders to allow directories to be loaded recursively, as well as individual files
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a bug-fix release for Release 5.1.10 that fixes a serious issue affecting the operation of the official plugin library.
See GitHub for detailed change history of this release
Major Improvements
New Editor Toolbars
Added support for extensible formatting toolbars for the editor widgets.
- Formatting operations for WikiText, with support for Markdown:
- Character formatting operations for bold, italic, strikethrough, underline, superscript, subscript, inline monospace
- Line formatting operations for monospaced blocks, quoting, headings and both numbered and bulleted lists
- Insert picture from a dropdown chooser
- Stamp snippet of pre-programmed text
- Excise selected text into a new tiddler
- Optional automatic resizing to fit content
- Full keyboard shortcut editor in control panel. Shortcuts are also shown in the toolbar button tooltips
Improved Bitmap Editor
The bitmap editor has been enhanced with a toolbar supporting:
- Painting with selectable colour, width and opacity
- Clearing the image
- Resizing the image
- Keeping track of recently chosen colours
Improved Plugins
Several of the official plugins available in the plugin library have been updated for this release. Upgrading will automatically update any installed plugins.
- The KaTeX plugin has been updated to version v0.60.0
- The CodeMirror plugin has been updated to version 5.13.2, and integrated with the new editor toolbars. The default configuration has been updated to include syntax highlighting for HTML, JavaScript, CSS, XML, TiddlyWiki Classic and Markdown.
- The Markdown plugin includes formatting toolbar buttons and a new "new markdown tiddler" button in the Tools tab of the sidebar.
- The experimental Evernote plugin allows notes and images from
.enexfiles to be imported into TiddlyWiki. - The new Internals plugin provides features to help understand the internal operation of TiddlyWiki, including new preview modes in the editor showing both the parse and widget trees of the current tiddler
- Improved language translations:
- Korean
- Chinese (Simplified) and Chinese (Traditional)
- German
- French
- Danish
- Dutch
Text-Slicer Plugin Improvements
- Added support for sticky notes within documents
- Extended support for slicing documents to Node.js
- Improved document metadata display
- Added
list-childrenfilter operator - Fixed bugs
Other Improvements
Usability Improvements
- Added a setting for disabling linking to missing tiddlers
- Added a setting for forcing word wrapping in monospaced code blocks
- Added a warning when creating or editing tiddler titles containing troublesome characters
- Addition of “new image” button to the “Tools” tab of the sidebar
- Introduction of new general purpose colour-picker Macro
- Introduction of new general purpose image-picker Macro
- Added a bulk delete button to advanced search "Filter" tab
Hackability Improvements
- Introduction of the new WikifyWidget
- Introduction of new EditShortcutWidget for direct entry of keyboard shortcut codes
- Extended editor preview pane to allow plugins to add further types of preview (see the new
tiddlywiki/internalsplugin for an example) - Added a simple HTTP PUT saver for use with WebDav or REST servers
- Added build targets to the server edition
- Improved days Operator to better cope with operations on today and yesterday
- Extended ActionWidgets mechanism to allow them to be used with the LinkCatcherWidget and SelectWidget
- Added
mobile-web-app-capablemeta tag for Android Chrome - Added new
plainwikifiedformat for the ViewWidget
Bug Fixes
- Fixed problem with tiddler titles containing single quotes in Table-of-Contents Macros
- Fixed problem with z-ordering of modals in zoomin story view
- Fixed problem with has Operator
- Fixed problem with double byte entities in the EntityWidget
- Fixed problem with ScrollableWidget in static renderings
- Fixed problem with repeatedly lazy loading of tiddlers without a text field
- Fixed problem with titles containing URLs being interpreted as external links
Node.js Improvements
- Added ability to customise the paths used for tiddler saving
- Fixed problem saving non-JPG binary files
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a minor bug fix release.
Bug Fixes
- Fixed (and refixed) problematic stricter external link matching rules introduced in 5.1.12
- Fixed problem with tiddlers titled "undefined"
- Fixed rendering problem with KaTeX Plugin
- Removed unneeded border in print stylesheet
Node.js Bug Fixes
- Fixed problem with extraneous
.tidextension added to tiddler filenames
Other Improvements
- Updated Portuguese (Portugal) translation
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
New and Improved Plugins
- Added SaveTrail Plugin that continuously downloads edited tiddlers in the background, providing a trail of backups
- Added XLSX Utilities plugin for importing Excel-compatible spreadsheets. See the XLSX Utilities Edition for details
- Added QR code generator plugin
- Added BibTeX importer plugin
- Updated Google Analytics plugin to the latest version
- Added Twitter Plugin for embedding tweets etc
- Updated KaTeX Plugin to v0.7.1 of KaTeX
Improved Support for Drag and Drop
There are several improvements to Drag and Drop:
- Ability to rearrange the "Open" sidebar panel and the tag dropdown (and new tiddlers can be opened by dragging them to the list)
- Ability to reorder entries in tag dropdowns
- Dragging a tag pill is now equivalent to dragging all of the tagged tiddlers together
- Entries in the control panel "Appearance"/"Toolbars" tab can be reordered by drag and drop
- The image shown while dragging now reflects the dragged item, instead of being a generic drag pill
New "Heavier" Theme
A new theme called "Heavier" thickens TiddlyWiki's default lightweight fonts. A variant "Tight-Heavier" combines the "Heavier" theme with the existing "Tight" theme:
New Tiddler Manager
Added new tiddler manager to support tasks such as:
- Reviewing and applying tags to a large number of tiddlers
- Tweaking the custom colours and icons for a large number of tiddlers
The tiddler manager will be extended in the future to increase flexibility and to add support for bulk operations.
Performance Improvements
- Extended search mechanism to require the search string to be a minimum length
Translation Improvements
- Improvements to Danish, Dutch, French, German, Portuguese and Chinese translations
- Added new Hebrew translation
- Added preliminary support for right-to-left (RTL) languages
Usability Improvements
- Added a select all/none checkbox to the header of the import panel
- Added "close plugin library" button
- Added support for adding tags using the enter key
- Improved handling of ctrl-Enter to add partially completed tags and fields
- Added support for relinking references to renamed tiddlers
- Added new "print page" page control button (and added associated icon)
- Added new page control button to temporarily suspend timestamps
- Improved access to plugin information:
- Refactored the display of plugin tiddlers to use the same format as the control panel, adding the shadow tiddler listing as an overridable extension tab
- Added a new tab in the “More” sidebar providing quick access to all installed plugins
- Fixed height of preview pane to use a scrollbar when fixed height layout is selected
- Extended editor "link" button to create external links and missing links
- Increased size of icons in the "Filter" tab of $:/AdvancedSearch
- Fixed problem with multiple copies of a tiddler appearing in the story river
- Improved dropdown for new field names with typeahead search
- Improved the ordering of groups in the tiddler editor content type dropdown
- Added "sticky" mode for tiddler info panel. See "Settings" in control panel
- Increased boldness of tag pill text
- Added documentation marker to indicate the version in which a new feature was released
- Added an entry to the advanced search filter drop down for exporting the current story (minus advanced search)
New and Improved Filter Operators
- Added new enlist Operator
- Added several new filter operators for string encoding/decoding:
- Added new minlength Operator
- Added new order Operator
- Added strict mode to tag Operator
- Added new tags option to the all Operator
- Changed is Operator to pass through arguments if the operand is blank
- Added "field" suffix for has Operator
- Improved wikiparserrules Operator to return all available parse rules
Hackability Improvements
- Added support for "formattedtext" output type to the WikifyWidget
- Added a saver for the peer-to-peer Beaker browser; see TiddlyWiki on Beaker Browser for details
- Refactored the tag templates and macros to make them more reusable
- Improved modals and notifications so that global macros are available
- Extended the SetWidget to allow a single result to be selected from a filtered result list
- Added new
$:/info/url/*information tiddlers providing document location information - Added support for the actions attribute to the CheckboxWidget
- Extended CheckboxWidget to support data tiddlers via the
indexattribute - Added new entry to the advanced search filtered export menu for exporting the current story river
- Added
tagattribute to the KeyboardWidget - Added overwrite protection to the WebDAV saver
- Added new "big block quote" style for Block Quotes in WikiText
- Added customisable template text for new journal tiddlers, accessible the control panel
- Added support for
.jsontiddler files containing a single tiddler object, instead of an array of tiddlers
Node.js Improvements
- Fixed multiple issues the creation of new tiddler files by the filesystem adaptor
- Added new FetchCommand for retrieving tiddlers over http/https
- Enhanced RenderTiddlerCommand to add support for an additional variable
Bug Fixes
- Improved Node.js support for the HighlightPlugin
- Fixed problem with recursion errors in the Table-of-Contents Macros
- Prevented email addresses from being mis-recognised as HTML tags
- Fixed issue with
$tw.utils.strEndsWith() - Partially fixed problem with action widgets being invoked independently of refresh cycle
- Revised handling of
syncAdaptor.isReady()method to improve compatibility with older adaptors - Fixed problem with unsafe use of
String.prototype.replace(), corrupting fields containing dollar signs - Fixed problem with page background colour not showing through transparent background images
- Fixed sync problem with skinny tiddlers not being loaded
- Fixed problem with "Cancel" button in login dialogue also submitting the form
- Fixed typo affecting created/creator fields when deleting a field
- Fixed issue with system links containing international characters not being recognised
- Fixed issue with single line macro definitions without a terminating line break
- Fixed issue with empty strings and the CheckboxWidget
- Fixed problem with calculation of week numbers
- Fixed problem with move Operator not wrapping correctly
- Fixed problem preventing customisation of textarea background colours
Developer Bug Fixes and Improvements
- Updated Stanford JavaScript Library to version v1.0.6
- Updated Google Analytics plugin to latest version of Google's code
- Improved Common/JS compatibility by adding support for implicitly adding
/index.jsto a require target - Improved support for bulk loading tiddler files via tiddlywiki.files Files within TiddlyWikiFolders
- Refactored server mechanism to make it simpler to integrate TiddlyWiki into ExpressJS apps
- Refactored the TiddlyFox saver module to make it easier to use it with other saving mechanisms
- Added (and here) several new UI hooks, and improved the hook mechanism; see developer docs
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
New and Improved Plugins
- New Amazon Web Services Plugin with primitives for running TiddlyWiki in the cloud
- New External Attachments Plugin that allows automatic creation of ExternalImages for TiddlyDesktop
Translation Improvements
New and improved translations:
- New Persian translation
- Updated Chinese and Greek translations
Another improvement that benefits users of translations is the addition of about 800 new transliteration pairs. These are substitutions that are performed when converting a tiddler title into a filename, such as the two characters "oe" for the single character "œ". See the commit for more details. The result is that automatically generated filenames are much more readable.
Usability Improvements
- Added new "Explorer" tab to "More" sidebar and underlying tree Macro
- Added configuration option in theme tweaks for the editor font
Hackability Improvements
- Added new lookup Operator to simplify use of lookup tables
- Extended the SetWidget with tiddler, field and index attributes
- Added new whitespace Pragma allowing whitespace to be selectively ignored within wikitext
- Updated support for saving in Beaker Browser
- Extended date formatting to support milliseconds and UTC dates
- Extended LinkCatcherWidget to make the target tiddler available within the action string
- Extended (and here) the DropzoneWidget and BrowseWidget to allow the deserializer to be manually specified
- Added new
tc-btn-*classes to toolbar buttons allowing easier custom styling - Added new mode attribute to the ViewWidget, allowing control over the parsing mode for wikified output formats
- Added new jsonstringify Operator
Node.js Improvements
- Added SaveCommand and RenderCommand, intended as more flexible replacements for RenderTiddlerCommand, RenderTiddlersCommand, SaveTiddlerCommand and SaveTiddlersCommand
- Added (and here) more colour to command line output
- Added new "raw" options to the FetchCommand
- Added new ImportCommand
Bug Fixes
- Fixed problem with "new journal" button clearing the text field
- Removed extraneous URI encoding of filename with PUT saver
- Restored ability to use sub-filter with image-picker macro
- Fixed problem with the download saver and filenames containing spaces, accents or other characters that need URL encoding
- Fixed problem with importing JSON tiddlers with leading or trailing spaces in the title
- Fixed plugin display so that "contents" tab is shown even if no other tabs are provided
- Fixed problem with
allbefore:includefilter operator - Updated Update Stanford JavaScript Library to version 1.0.7
Developer Bug Fixes and Improvements
- Extended
$tw.boot.boot()to add a callback parameter - Extended navigation handling to pass original event data
- Added new
th-importing-fileshook
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Improved CodeMirror Plugins
The CodeMirror plugin has undergone a substantial rewrite, with many new improvements:
- Upgrade to CodeMirror version v5.37.0
- Now modularised into:
- Base plugin: basic lightweight configuration, approximately 240KB
- Add-on plugins:
- Search and Replace
- Auto-completion
- Fullscreen editing
- Auto-close brackets
- Auto-close tags
- SublimeText keymap
- Emacs keymap
- Vim keymap
- Highlighting modes: Javascript, Xml, Html (htmlmixed), Html (htmlembedded), Css, Markdown, X-Tiddlywiki
- Automatic configuration (the configuration tiddler is not needed anymore)
- CodeMirror (engine.js) builds the configuration using information within the installed CodeMirror plugins
- New control panel configuration tab:
- Line numbers
- Theme:
- Editor font family (same as native TiddlyWiki)
- Cursor settings
- Line wrapping
- Active line highlighting
- Autocompletion on/off (if installed)
- Keymap
Other New and Improved Plugins
- New Dynaview Plugin makes it possible to build user interfaces that dynamically respond to changes in scrolling or zooming
- Improved Text-Slicer Plugin with customisable JSON rules
- Updated KaTeX Plugin to latest v0.9.0
Translation Improvements
New and improved translations:
- New Slovenian translation
- New Português (Brasil) translation
- Improved Dutch translation
- Improved French translation
- Improved German translation
- Improved Traditional and Simplified Chinese translations
- These translations now also reset the minimum search length to one character
Privacy Improvements
Prompted by the General Data Protection Regulation (GDPR), we've removed all third party cookies from tiddlywiki.com.
Usability Improvements
- Added new DiffTextWidget, and integrated it into the import listing and as a preview pane
- Added selectable previews to the import listing
- Added new editor toolbar buttons for wrapping the selection with double square and curly brackets
- Added new sortan Operator for sorting alphanumeric values such as "Apple 6", "Apple 7", "Apple 8", "Apple 9", "Apple 10", "Apple 20", "Apple 30", "Apple 100"
- Improved default fonts for readability as advised by GitHub
- Added an editor toolbar button for stamping fragments of formulae for the KaTeX Plugin
- Simplified the page scrolling behaviour: navigating to a tiddler now scrolls the top of the tiddler to the top of the viewport
- Added WidgetMessage: tm-copy-to-clipboard and also copy-to-clipboard Macro for copying text directly to the clipboard
- Added a hint to the field list dropdown
- Added a control panel setting for the default tab in the More sidebar
- Added a control panel setting for the titles of new tiddlers
- Added "rotate left" button to bitmap editor toolbar
- Improved criteria under which certain editor toolbar buttons are displayed
- Added support for a minimum length for the new tag field before the dropdown is shown
- Improved consistency and reusability of the palette, language and theme switchers
- Added support for retaining tab content in the tabs Macro
- Added support for adding links via the enter key
Hackability Improvements
- Added support for comparison operators to the RevealWidget
- Added support for StartupActions to execute action widgets at startup
- Extended ServerCommand to allow the port number to be specified as an environment variable
- Added screen width/height to platform information exposed at startup
- Extended DroppableWidget to pass modifier keys in a variable
- Extended DraggableWidget with actions for drag start and drag end
- Added a new TaskManagementExample (Draggable)
- Added new 'Stylesheets' tab to control panel
- Added new 'emptyMessage' parameter to list-links Macro and list-tagged-draggable Macro
- Added new
th-page-refreshedhook - Enhanced macro evaluation by making parameters available as variables - see "Parameters as Variables" in Macro Definitions in WikiText
- Enhanced LinkWidget to allow better customisation of CSS classes
- Added new "value" suffix for the each Operator
- Added new subtiddler attribute to the SetWidget
- Added new subtiddlerfields Operator for extracting the fields from tiddlers within plugins
- Added ability to trigger actions on unchecking the CheckboxWidget
- Added support for a checked class to the RadioWidget
- Extended the is Operator to allow multiple types to be specified
- Added data attributes to ViewTemplate (see Custom data-styles)
- Added new RangeWidget
Bug Fixes
- Removed superfluous list item at the end of list-links-draggable macro
- Fixed problem with the content area of vertical tabs sometimes overflowing their right hand margin
- Fixed problem with double quotes within the new journal template
- Fixed problem with dragging inside a textarea
- Fixed usage of "default" attribute of SelectWidget when "index" attribute is used
- Fixed problem with crash when dragging over TiddlyWiki on some browsers
- Fixed issue with new journal button
- Fixed problem with filter and value attributes of SetWidget
- Fixed problem with numeric operands in the The Extended Listops Filters
- Fixed problem with "put" saver and 412 return codes
- Fixed problem with variable references in field values in the edit template
- Extended behaviour of list-after field so that the tiddler is placed at the end of the list if the list-after field is present but empty
Developer Bug Fixes and Improvements
- Added plugin-priority field to core plugins
- Fixed problems with plugin ordering
- Several optimisations to the tiddler store:
- Avoiding slow Object.keys calls - saving 50% of some operations
- Optimising the tag filter - saving 50% on some tag operations
- Minor improvements to tiddler deletion
- Added support for custom boot paths
- Added new navigation hooks:
th-cancelling-tiddler,th-new-tiddlerandth-renaming-tiddler - Added new hook when the HTTP server starts
th-server-command-post-start
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Reversions
After encountering significant problems we've reluctantly decided to remove support for multiple sub-operators with the is Operator that was added in v5.1.16.
Usability Improvements
- Improved appearance of TiddlyWiki's "red screen of embarrassment"
Bug Fixes
- Fixed problem with extraneous space in new journal titles
- Fixed problem with repeated use of "new journal" with text set
- Fixed (and here) problem with Etag handling
- Fixed problem with is Operator introduced in 5.1.16
- Restored default of the preview pane being hidden
- Fixed incorrect plugin library location
- Fixed animation timing problem with reveal widget that sometimes caused the sidebar not to show when requested
- Fixed problem with saving with non-Dat URI schemes
- Fixed deletion of
$:/status/UserNamewhen logged out
Node.js Improvements
- Stopped clearing $:/status/UserName when logged out
- Fixed bug with attempting to lazy load tiddlers that do not qualify for syncing
- Added support for
/*\style metadata comments at the top of*.CSSfiles
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Major Improvements
Global Keyboard Shortcuts
This version introduces new infrastructure to handle global keyboard shortcuts. The core ships with the following shortcuts:
- alt-I (or ctrl-I on Mac) - New image
- alt-J (or ctrl-J on Mac) - New journal
- alt-N (or ctrl-N on Mac) - New tiddler
See How to create keyboard shortcuts
Node.js HTTP Server
The HTTP WebServer functionality has been significantly improved:
- Adds ability to make a wiki that is read-only for anonymous users (with the editing UI hidden), but allows editing for users who log in
- Hides UI features like the new tiddler button and the edit button when the user only has read-only access to the wiki
- Adds support for serving static file attachments over HTTP
- Adds support for multiple user credentials for basic authentication via a CSV file containing usernames/passwords
- Adds support for serving over HTTPS as well as HTTP
- Adds support for authentication via a trusted header, making it easier to integrate with corporate single sign on (and Windows authentication)
- Adds support for more fine grained authorisation (ie granting/denying individual users read/write permission to resources)
- Better debugging information
- Experimental support for a new, plain HTML single tiddler per page view
- Adds a simple level of CSRF protection
- Deprecating the existing ServerCommand in favour of a new ListenCommand using the new NamedCommandParameters support for named parameters that can be specified in any order
- Refactoring routes as separate modules, making it easier to extend the server with new functionality
See WebServer for more details, or see the changes on GitHub.
Special Characters in Tiddler Titles
In previous versions of TiddlyWiki, there were some special character sequences in tiddler titles that would break certain features. For example, a tiddler title ending in double quotes would cause the Table-of-Contents Macros to render incorrectly.
As of 5.1.18, many of these problems have been fixed by refactoring the features to use the latest abilities of wikitext:
Note that using certain characters in tiddler titles will still prevent some features from being used correctly. For example, two vertical bar characters are used in the double curly braces transclusion syntax to separate the tiddler title from the template title: {{title||template}}. However, although it would be impossible to transclude a tiddler called title||template using that syntax, one could still transclude it using <$transclude tiddler="title||template"/>.
Plugin Improvements
- KaTeX Plugin – the KaTeX Plugin has been updated to KaTeX v0.10.0. The plugin now incorporates an extension for chemical formulae
- Comment Plugin – this release adds a new commenting plugin – see $:/plugins/tiddlywiki/comments
- AWS Plugin – support for running TiddlyWiki as a Lambda function has been improved with support for GZip compression of the JSON payload
Translation Improvements
New and improved translations:
- Catalan
- Chinese Simplified and Chinese Traditional
- Dutch
- French
- German
Usability Improvements
- Added support for splash screens to be shown while TiddlyWiki is loading – see Creating a splash screen
- Added display of backlinks when renaming a tiddler
- Added persistent indicators at the bottom of the window showing any hidden drafts
- Added current username (if set) to the title of draft tiddlers, making them easier to identify in multiuser scenarios
- Added a warning for binary tiddlers in view mode
- Extended permalink/permaview to copy the URL to the clipboard as well as updating the address bar. This behaviour can be customised in $:/ControlPanel settings
- Improved saving to use the $:/SiteTitle as the basis of the filename
- Added support for webp, heic and heif image formats
- Fixed tiddler positioning when creating new tiddlers
- Fixed smooth scrolling in new windows
- Fixed problem dismissing popups within new windows
- Fixed handling of disabled missing links so that core user interface features are not broken (see also here)
Hackability Improvements
- Added a new filter prefix
~allowing if-then-else logic within filters – see Filter Expression - Added a new subfilter Operator to allow nested filters to be used
- Added new stateTitle, stateField and stateIndex attributes to the ButtonWidget and the RevealWidget, making it possible to use state tiddlers whose titles contain
!!or## - Enhanced the search Operator to support searching arbitrary lists of fields, literal searches, whitespace-tolerant searches and regexp searches
- Added new contains Operator for searching within list fields
- Added support for a navigation scroll offset to avoid navigating to tiddlers resulting in them being obscured under a
position:fixedtop menu bar – see Hidden Setting: Scroll Top Adjustment - Extended WidgetMessage: tm-full-screen message to support forcing the status instead of just toggling it
- Refactored the sidebar to make it be dynamically built from the tag
- Refactored the tiddler info panel to make it be dynamically built from the tag
- Added new range Operator for generating ranges of numbers
- Added palette support for
<select>element colouring - Added new text editor operation save-selection – see WidgetMessage: tm-edit-text-operation
- Added support for editor toolbar buttons to have action widgets
- Added support for rebasing headings at render time – see tv-adjust-heading-level Variable
- Added experimental support for packaging TiddlyWiki's JavaScript core into an external script for use with the new Web Server enhancements
- Added new
\importPragma as a more concise alternative to using the ImportVariablesWidget directly - Added (and here) new tv-show-missing-links Variable for tighter control over rendering of missing links by the LinkWidget
Bug Fixes
- Fixed with WidgetMessage: tm-new-tiddler overwriting creation fields of existing tiddlers
- Fixed problem with unwanted variable substitutions by restricting variable substitutions to macros defined with the define pragma
- Fixed problem with the 'excise' editor toolbar button not showing if the tiddler type is "text/vnd.tiddlywiki"
- Fixed problem with generation of wifi QR codes
- Fixed $tw.platform.isLinux on the latest Firefox
- Fixed problem with using full screen on secondary windows
- Fixed subtle bug whereby the RevealWidget was not refreshing properly when the state tiddler of a popup changed
- Fixed problem with malformed HTML entities
- Fixed crash when passing illegal arguments to the decodeuri Operator and decodeuricomponent Operator
- Fixed errors when a popup blocker blocks opening a new window
- Fixed problems using a lazily loaded tidler as a state tiddler with the RevealWidget
- Fixed problem with modals not appearing in the correct window
- Fixed the animations for adding and removing tags in edit mode, and a similar fix for the animations in the "Open" sidebar tab
Developer Bug Fixes and Improvements
- Refactored
$tw.utils.parseStringArray()to optionally allow non-unique entries
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This release consists of fixes for bugs discovered in Release 5.1.18.
Hackability Improvements
Bug Fixes
- Fixed incompatible change to the construction of filename used for saving
- Fixed problem with fonts for the KaTeX Plugin
- Fixed problem with forcing basic authentication for the WebServer
- Fixed problem with the ButtonWidget not refreshing when the
popupTitleattribute changes - Fixed problem with
empty.htmlaccidentally containing a splash screen - Fixed regression with search matches across multiple fields
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
Voir GitHub pour un historique détaillé des modifications apportées par de cette version
Une nouvelle version mineure avec des mises à jour de la documentation, quelques corrections de bugs, et quelques améliorations.
Améliorations d'usage
- Amélioration de la gestion des erreurs liées au plugin KaTeX pour les cas où le contenu LaTeX est malformé ou non reconnu.
Améliorations pour les bricoleurs
- Amélioration du style du séparateur avant l'article sans étiquette dans la liste des tags de la barre latérale
- Amélioration de la gestion d'erreur lors pour l'enregistreur de type dépôt (qui est utilisé pour enregistrer vers TiddlySpot)
- Amélioration de la détection d'erreurs dans la vue sur le déroulé
Correction d'erreurs
- Correction des crashs causé par des plugins mal formatés
- Correction d'un problème faisant que les informations sur un tiddler n'étaient pas supprimées par le plugin de synchronisation après la suppression d'un tiddler
- Correction de la gestion HTTP pour considérer le code de réponse 201 comme un succès.
Contributeurs
@Jermolene aimerait remercier les contributeurs de cette version, qui ont généreusement donné de leur temps pour aider à améliorer TiddlyWiki :
See GitHub for detailed change history of this release
Usability Improvements
- Added "new journal" button; see Creating journal tiddlers
- Added "new here" button; see Creating and editing tiddlers
- Added "new journal here" button; see Creating journal tiddlers
- Made date format strings be translateable
- Added Russian translation
- Added confirmation when clearing password
- Added additional prompt when setting password
- Increased size of the clear search button
- Upgraded to KaTeX v0.1.1, with support for several additional LaTeX features
Hackability Improvements
- Added audio "parser" for handling Audio content
- Added support for ActionWidgets
- Added new
addprefixandaddsuffixoperators - Added support for custom password prompts
- Extended the
list-linksmacro to display caption field if present - Extended ImageWidget to allow percentage width and height to be specified
Bug Fixes
- Fixed the
eachoperator to work with missing tiddlers - Fixed problem with tiddler width in zoomin storyview with the sidebar hidden
- Fixed bug whereby the
tm-homemessage wasn't navigating to a tiddler, causing problems in zoomin storyview - Fixed problem with jumping toolbar icons under Firefox
- Fixed problem with untagged label being incorrectly coloured
- Fixed problem with title background colours with the "Sticky Titles" theme
- Fixed problem with subfilter parameter of
timelinemacro - Exclude search string tiddler from search results
Node.js Changes
These changes are only relevant to people using TiddlyWiki under Node.js
- Extended KaTeX plugin to be able to work under Node.js to generate static HTML
- Extended "includeWikis" to merge build targets
- Refactored the build scripts for tiddlywiki.com into a separate repository at https://github.com/Jermolene/build.jermolene.github.io
- Extended boot kernel to raise an error if a missing wiki folder is specified on the command line
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is a small release with documentation improvements and some important bug fixes from Release 5.1.3.
Usability Improvements
- Added a toolbar button for advanced search
- Changed dragging behaviour so that you can drag a tiddler title into an edit box to insert the title, making link creation easier. (This change doesn't affect the behaviour of dragging tiddler links between TiddlyWiki windows)
Hackability Improvements
- Added additional theme tweaks for the body text size and line height
- Extended the ViewWidget to work with subtiddlers
Bug Fixes
- Fixed problem with search counts
Node.js Changes
These changes are only relevant to people using TiddlyWiki under Node.js
- Fixed problem with missing wiki folder warnings by removing and re-implementing the fix from Release 5.1.3
- Added coloured warnings and errors under Node.js
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Translation Improvements
- Added new translators edition making it much easier to create and maintain translations of TiddlyWiki
- Added improved Japanese translation
- Added new Danish translation
- Added new Greek translation
Usability Improvements
- Improvements to tooltips for accessibility
- Added export button to tiddler toolbar, page controls and advanced search "filter" tab
- Improved layout of $:/TagManager
- Simplified default tiddler toolbar buttons
- Added advanced search button to sidebar search results
- Improved search results by listing title matches at the top
- Added input box for specifying new field value in edit template
- Improved tag pill rendering so that the foreground colour is dynamically chosen for maximum contrast with the background colour
- Enhancements to many of the core icons
- Removed (and here, here and here) unnecessary confirmations when abandoning or deleting unmodified tiddlers
- Added a subtle rounded corner to tiddlers and tabs
- Added automatic focusing of the title of newly created tiddlers
- Added advanced search links on tiddler counts in $:/ControlPanel
Hackability Improvements
- Introduced new ActionSetFieldWidget, ActionDeleteFieldWidget and ActionDeleteTiddlerWidget for manipulating tiddler fields and values
- Enhanced WidgetMessage: tm-new-tiddler to allow a skeleton to be specified with additional fields
- Enhanced the EditTextWidget to allow more control over the sizing of textarea editors
- Added new canned filter for recently modified system tiddlers in $:/AdvancedSearch
- Added new system image for videos: $:/core/images/video
- Extended search results to allow custom visualisations - see Customising search results
- Extended
timelinemacro to be able to use different date fields - Updated the
searchoperator to allow a field to be specified - Updated the highlight plugin to display tabs as spaces
- Extended modal handling to permit variables to be passed to the modal (see WidgetMessage: tm-modal)
- Added simple logging to help track down drop/paste issues (see https://tiddlywiki.com/dev/#ImportLogging)
- Updated WidgetMessage: tm-download-file and WidgetMessage: tm-save-wiki to allow variables to be specified for the rendering
- Added Example Table of Contents: Tabbed Internal
- Extended RevealWidget so that it can be used without specifying a state tiddler
- Added "hooks" mechanism so that plugins can modify the default tiddler list
- Added support for nested popups
Bug Fixes
- Fixed problem with CodeMirror editor and missing tiddlers
- Exclude drafts from Table-of-Contents Macros
- Fixed problem with encoding of HTML tiddlers
- Fixed problem with sticky titles being covered by vertical tabs
- Removed flicker when automatically resizing textareas
- Fixed JSON deserialiser so that all fields can be imported
Node.js Changes
These changes are only relevant to people using TiddlyWiki under Node.js
- Extended includeWikis mechanism of TiddlyWikiFolders to allow read-only wikis to be included
- Improved error handling under Node.js
- Added UnpackPluginCommand
- Added EditionsCommand to list the available editions
Changes affecting plugin authors
- Disabled wiki change events for shadow tiddlers
- Updated structure of widget messages that have a hashmap parameter
- The support for nested popups has necessitated a change in the way that popups are styled that affects popups that are triggered with the focusPopup attribute of the EditTextWidget: it is now necessary for the widget to be given the class
tc-popup-handle.
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
Translation Improvements
- Added Dutch translation
- Updated Danish and Japanese translations
Hackability Improvements
- Allow buttons to be styled to look like internal links
- Disabled linking when transcluding caption field in Table-of-Contents Macros
- Added support for templates to tabbed Table-of-Contents Macros
- Allow shadow tiddlers to appear in Table-of-Contents Macros
- Added tooltip to BrowseWidget
- Improved handling of missing tiddlers by the
hasandfieldoperators
Bug Fixes
- Fixed problem with download saver using incorrect filename
- Fixed problem with processing of date format templates
- Fixed problem with storytop theme tweak not being respected when the narrow responsive design kicks in
Node.js Changes
These changes are only relevant to people using TiddlyWiki under Node.js
- Fixed problem with "all tiddlers" static HTML export
- Fixed incorrect checking for an empty folder with the InitCommand
Changes affecting plugin authors
- Extended
$tw.utils.eachso that the loop can be broken out of
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
See GitHub for detailed change history of this release
This is an hot fix release with the following change over Release 5.1.6:
- Fixed typo in GettingStarted
Rendez-vous sur GitHub pour l'historique détaillé des évolutions de cette version
Cette version intègre plusieurs améliorations à la documentation de TiddlyWiki. Tous mes remerciements à tous ceux qui y ont contribué, et spécialement à notre prodigieux nouveau contributeur Astrid Elocson.
Améliorations linguistiques
- Amélioration des traductions Française, Danoise, Chinoise et Japonaise
- Ajout de la traduction Tchèque
- Ajout de la traduction Interlingua
- Ajout de la traduction Portugaise
- Ajout de la traduction Indou et Punjabe
- Ajout de la traduction Slovaque
- Ajout de la traduction Espagnole
- Ajout localisation de l'invite de cryptage
Améliorations ergonomiques
- Ajoute une d'interface utilisateur pour régler l'image d'arrière plan
- Corrige un problème avec un défilement inutile au démarrage
- Actualise le Plugin KaTeX vers le KaTeX v0.2.0, pour un meilleur support des symboles
- Ajoute l'affichage d'un panneau d'aide flottant au Plugin Help
- Ajoute le support d'une bibliothèque de plugins en ligne
- Ajoute la sélection automatique de la zone de recherche au démarrage
- Intègre le Plugin Railroad par Astrid Elocson (le voir en action dans la nouvelle documentation de la Syntaxe des filtres)
- Migre la fonctionnalité "Titres Stickés", par un réglage optionnel, des thèmes "Vanilla"/"Snow White". Ainsi les titres des tiddlers collent au haut de la fenêtre pendant le défilement pour les navigateurs qui l'acceptent
position: sticky(comme Safari et Firefox) - Ajoute des icones à RechercheAvancée, PanneauDeContrôle et GestionDesÉtiquettes
- Change le libellé du bouton du tiddler "save" pour "confirm"
- Ajoute la liaison automatique à des tiddlers système tels que $:/ControlPanel
- Améliore le déroulé des listes de titres correspondant à l'étiquette
- Ajoute une bannière avertissant l'utilisateur quand la modification de plugins demande la réactualisation de la page
- Ajoute une première passe à la vue du déroulé "empilé"
- Change les entêtes et pieds de page modaux afin d'être analysés par défaut dans le mode enligne (en évitant les balises
<p>inutiles)
Améliorations Technologiques
- Ajoute la Macro ResolvePath
- Ajoute l'attribut class au CheckboxWidget
- Ajoute le support d'affichage de message spécial si le déroulé principal est vide
- Améliore le rendu des polices sous Mac OS X
- Ajoute le support d'inclusion des fichiers ZIP
- Ajoute le support d'éléments personnalisés par le RevealWidget
- Ajoute l'attribut style au RevealWidget
- Corrige l'utilisation de palette de couleurs dans les entrées de texte
- Plusieurs nouveaux icones au noyau:
Corrections de Bogues
- Corrige les opérateurs sameday et eachday pour accepter les chaines de date TW5
- Corrige les tests de compatibilité des numéros de version pour lesplugins
- Corrige un problème avec l'annulation répétée d'une ébauche
- Améliore la mise au bacasable des éléments
<iframe>générés - Corrige un problème avec le mode arrière plan sur Firefox
- Corrige un problème de glissé accidentel d'un tiddler dans sa fenêtre originale
- Corrige un problème avec le glissé de certains plugins avec Safari
- Corrige en partie un problème avec les icones SVG coupées d'1 pixel sur la droite et en bas
- Corrige un problème avec les doubles cotes dans la valeur d'un nouveau champ
Modification de Node.js
Ces modifications affectent seulement les utilisateurs de TiddlyWiki sous Node.js
- Corrige le Plugin Highlight pour fonctionner pendant la génération de fichiers statiques sous Node.js
- Corrige un problème avec l'insensibilité à la casse sous certains systèmes (par exemple, Windows)
- Ajoute un metada mobile aux gabarits de pages statiques
- Ajoute un paramètre "noclean" au RenderTiddlersCommand
- Ajoute les opérateurs editions et editiondescription pour énumérer les éditions disponibles
Contributeurs
@Jermolene tient à remercier tous les contributeurs de cette version qui ont généreusement donné de leur temps pour aider à l'amélioration de TiddlyWiki:
See GitHub for detailed change history of this release
Major Improvements
New "Powered by TiddlyWiki" plugin
An experimental plugin to add a simple "Powered by TiddlyWiki" banner to your site. It is included in this prerelease but will not be on the main tiddlywiki.com wiki.
New "Fluid story, fixed sidebar" mode
It is now possible to arrange the main window so that the sidebar has a fixed width and the story river expands to fill the remaining space.
To switch it on, visit Theme Tweaks in the $:/ControlPanel Appearance tab and use the following options:
- Sidebar layout:
- Fixed story, fluid sidebar (default) - the story river has a fixed width and the sidebar fills the remaining space
- Fluid story, fixed sidebar - the story river expands to fill horizontal space remaining after the fixed width sidebar
- Sidebar width:
- The width of the sidebar. Can be specified in pixels (eg 350px), a percentage (eg 25%) or other CSS unit
Toolbar Button Style Setting
A new setting in $:/ControlPanel Settings tab allows the toolbar button style to be chosen from the following options:
- the existing style
- , which adds a thin border box around the button
- , which rounds the button corners and inverts the button colours
Plugins can add new style options.
New Tiddler Toolbar Button: "Open in new window"
An experimental new tiddler toolbar button opens a single tiddler in a separate pop-up browser window. The tiddler will be dynamically updated just as in the main window. There are several uses:
- Arranging reference tiddlers for easy access while editing in the main window
- Making good use of multi-screen layouts
- Printing the content of a single tiddler
- Running presentations in a separate window while maintaining notes in the main window
Improvements for visually impaired users
- Improved monochrome palette variants:
- . Foreground: , Background:
- . Foreground: , Background:
New "Solar Flare" palette
There's a new core palette "Solar Flare", contributed by Rustem Akbulatov (@nameanyone).
Options for Story Control
There are new options for controlling the position in the story river of newly opened tiddlers. Visit the Settings tab of $:/ControlPanel and look for "Tiddler Opening Behaviour".
New Hidden Settings
Two new hidden settings for advanced configuration:
New Vars widget
Added VarsWidget for setting multiple variables in one operation:
<$vars greeting="Hi" me={{!!title}} sentence=<<helloworld>>>
<<greeting>>! I am <<me>> and I say: <<sentence>>
</$vars>Other Improvements
Translation Improvements
- Updates to the Dutch, Chinese, Italian and German translations
- New Catalan (Spain) translation
Usability Improvements
- Added new page control icon for setting the palette:
- Added new icons for palette and "open new window"
- Improved the theme icon to better match the new palette icon:
- Avoid glitch with autofocusing the search box in the plugin library
- Added information about TiddlyDesktop to Releases
- Stopped autosaving after cancelling an edit
- Added dropdown to edit template to allow existing field names to be selected
Hackability Improvements
- Updated to KaTeX version 0.4.3, with the following editions since the previous 0.2.0 release that was distributed with TiddlyWiki 5.1.8:
- Added support for some
\begin/\endenvironments, including support forarray,matrix,pmatrix,bmatrix,vmatrix, andVmatrix - Added support for optional
\sqrtarguments, e.g.\sqrt[3]{x} - Add support for
\phantom - Add
\#,\& - See the KaTeX GitHub page for full release details
- Added support for some
- Extended ActionSendMessageWidget for more flexible passing of named parameters via new
$nameand$valueattributes - Added styling for
<kbd>elements such as escape and enter - Added subtle new "pin stripe" pattern for page background -
- Added support for custom elements to the ButtonWidget
- Improved CodeMirror plugin to automatically refresh when a tiddler type changes
- Added new setting in $:/ControlPanel to render tiddler titles as links, which can be convenient for drag and drop
- Simplified detecting the preview pane with the tv-tiddler-preview Variable
- Improved automatic linking of system tiddler titles by restricting them to letters and the characters
/.-
Bug Fixes
- Fixed problem with special characters in field names
- Fixed static banner layout on mobile devices
- Fixed popups within the scrollable widget by adding
position: relative;to example scrollable widget styles
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
Voici la description des récentes mise à jour de TiddlyWiki5. Voir TiddlyWiki5 Versioning pour plus de détails sur la nomination des versions.
(Les versions Bêta et Alpha sont listées séparément).
Release 5.1.19
Released 20 décembre 2018 at 16:34
See GitHub for detailed change history of this release
This release consists of fixes for bugs discovered in Release 5.1.18.
Hackability Improvements
Bug Fixes
- Fixed incompatible change to the construction of filename used for saving
- Fixed problem with fonts for the KaTeX Plugin
- Fixed problem with forcing basic authentication for the WebServer
- Fixed problem with the ButtonWidget not refreshing when the
popupTitleattribute changes - Fixed problem with
empty.htmlaccidentally containing a splash screen - Fixed regression with search matches across multiple fields
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
| purpose | remove a list of titles specified in the operand from the input |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to all |
| parameter | array = an array of items to remove |
| output | items removed from current list that appear at the head of the operand array |
! output | items removed from current list that appear at the tail of the operand array |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] +[remove[Tuesday Wednesday Thursday]]
[list[Days of the Week]] +[remove:3[Monday Wednesday Friday Saturday]]
[list[Days of the Week]] +[!remove:2{Days of the Week!!list}]
| purpose | filter the input titles by how they start, deleting that prefix |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | those input titles that start with S, but with those characters discarded |
In looking for matches for S, capital and lowercase letters are treated as different.
| purpose | filter the input titles by how they end, deleting that suffix |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | those input titles that end with S, but with those characters discarded |
In looking for matches for S, capital and lowercase letters are treated as different.
Exécute le contenu des tiddlers individuels identifiés par un filtre et enregistre le résultat vers les fichiers spécifiés.
Optionellement, on peut spécifier le titre d'un tiddler modèle (template). Dans ce cas, au lieu d'exécuter directement le contenu de chaque tiddler, le modèle est exécuté après avoir donné pour valeur à la variable "currentTiddler" le titre du tiddler dont le contenu est en cours d'exécution.
On peut spécifier le nom et la valeur d'une variable supplémentaire.
--render <filtre-sur-les-tiddlers> [<filtre-des-noms-de-fichier>] [<type-de-rendu>] [<modèle>] [<nom>] [<valeur>]- filtre-sur-les-tiddlers: Un filtre qui indentifie les tiddlers dont le contenu doit être exécuté
- filtre-des-noms-de-fichier: filtre optionnel pour transformer les titres de tiddlers en chemin de fichiers. À défaut, le filtre utilisé est
[is[tiddler]addsuffix[.html]], qui utilise le titre inchangé du tiddler comme nom de fichier - modèle: Modèle optionnel via lequel chaque tiddler doit être rendu
- type-de-rendu: Type de rendu optionnel : la valeur
text/html(par défaut) retourne le text HTML complet ettext/plainse contente de retourner le contenu sous forme texte (autrement dit ignore les balises HTML et autres caractères non imprimables) - nom: Nom de la variable optionnelle
- valeur: Valeur de la variable optionnelle
Par défaut, le nom de fichier est résolu relativement au sous-répertoire output du réepertoire de l'édition. La commande --output peut servir à diriger les sorties vers un répertoire différent.
Notes :
- Les éventuels fichiers présents dans le répertoire de sortie ne sont pas supprimmés
- Les répertoires absents dans le chemin de fichier sont créés automatiquement.
- Lorsqu'un tiddler contient des espaces dans le titre, prendre garde à utiliser aussi bien les guillemets nécessaires au shell et les doubles crochets droits propres à TiddlyWiki :
--render "[[Motovun Jack.jpg]]" - Le filtre des noms de fichier est évalué après avoir initialisé l'élément d'entrée avec le titre du tiddler en cours d'exécution, permettant ainsi d'utiliser le titre comme base de calcul pour le nom de fichier. Par exemple
[encodeuricomponent[]addprefix[static/]]applique un encodage d'URI à chaque titre, puis ajoute le préfixestatic/ - La commande
--renderremplace de manière plus souple les deux commandes--rendertiddleret--rendertiddlers, qui sont du même coup obsolètes.
Exemples :
--render "[!is[system]]" "[encodeuricomponent[]addprefix[tiddlers/]addsuffix[.html]]"– enregistre le contenu exécuté de tous les tiddlers non-système vers des fichiers du sous-répertoire "tiddlers" nommés par encodage URL des titres et ajout d'une extension html.
Enregistre vers le chemin indiqué le résultat de l'exécution d'un tiddler pour le type de contenu (ContentType) spécifié — par défaut text/html.
Un tiddler modèle (template) peut être indiqué optionnellement. Dans ce cas, le tiddler modèle est exécuté après initialisation de la variable "currentTiddler" avec le tiddler dont le titre est donné en premier paramètre de la commande.
Le nom et la valeur d'une variable supplémentaire peuvent être spécifiés optionnellement.
--rendertiddler <titre> <chemindufichier> [<type>] [<modèle>] [<nom>] [<valeur>]Par défaut, le nom de fichier est résolu relativement au sous-répertoire output du répertoire de l'édition. La commande --output peut servir à rediriger la sortie vers un répertoire différent.
Les répertoires présents dans le chemin du fichier et qui n'existent pas encore sont créés automatiquement.
Par exemple, la commande ci-dessous enregistre tous les tiddlers correspondant au filtre [tag[done]] vers un fichier JSON de nom output.json, en faisant appel au template prédéfini $:/core/templates/exporters/JsonFile.
--rendertiddler "$:/core/templates/exporters/JsonFile" output.json text/plain "" exportFilter "[tag[done]]"Enregistre vers le chemin indiqué et avec l'extension indiquée — par défaut .html, le résultat de l'exécution d'un ensemble de tiddlers (sélectionnés par un filtre). Le résultat de l'exécution est rendu selon le type de contenu (ContentType) spécifié — par défaut text/html :
--rendertiddlers <filtre> <modèle> <chemindurépertoire> [<type>] [<extension>] ["noclean"]Par exemple :
--rendertiddlers [!is[system]] $:/core/templates/static.tiddler.html ./static text/plainPar défaut, le nom de fichier est résolu relativement au sous-répertoire output du répertoire de l'édition. La commande --output peut servir à rediriger la sortie vers un répertoire différent.
Tous les fichiers du répertoire cible sont supprimés, sauf si le drapeau noclean est spécifié. Le répertoire cible est créé récursivement s'il n'existe pas.
| purpose | replace marker with N trailing items |
|---|---|
| input | a list of items |
| suffix | an integer N, defaulting to 1 |
| parameter | marker = the item to be used as a marker |
| output | re-ordered list of items |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]] Last +[replace[Wednesday]]
[list[Days of the Week]] Last +[replace:2[Tuesday]]
[list[Days of the Week]] [[Yesterday]] [[Today]] [[Tomorrow]] +[replace:3[Tuesday]]
Vous pouvez signaler les bogues et les problèmes rencontrés avec TiddlyWiki sur nos groupes de discussions. Si vous avez un compte GitHub vous pouvez aussi le faire là :
https://github.com/Jermolene/TiddlyWiki5/issues/new
À moins que vous ne soyez un familier de GitHub, nos forums restent, en général, la façon la plus simple de faire part d'un problème.
TiddlyWiki sur GitHub
Nous utilisons le processus de questions sur GitHub pour gérer les rapports de bugs et demandes de fonctionnalités pour TiddlyWiki. Pour maintenir leur efficacité nous nous efforçons d'avoir aussi peu de questions en suspens que possible.
Politique de gestion des questions
Les questions en suspens se traduisent généralement : soit par un rapport de bogue reproductible, soit par une demande de fonctionnalité spécifique. Du point de vue des développeurs du noyau, la liste des questions se présente comme une liste de tâches partagée. Chaque élément de la liste demande un peu d'attention à chaque fois que nous vérifions la liste.
Les questionnements GitHub ne sont pas très efficaces pour gérer les idées qui ne sont pas réalisables immédiatement. Mieux vaut utiliser les forum TiddlyWiki pour les questions ouvertes, ou les discussions spéculatives sur de nouvelles fonctionnalités.
Soumettre une question
Avant de soumettre une question sur GitHub, il est de bon ton de chercher dans les questions existantes pour déterminer si le problème n'aurait pas déjà été posé. Si la recherche ne vous semble pas pratique, ne vous inquiétez pas trop ; Avec GitHub, il est facile de fusionner les questions existantes.
Lorsque vous devez soumettre un problème, gardez en mémoire que nous avons besoin du plus d'informations possibles pour une résolution efficace. Au minimum, veuillez essayer d'inclure :
- Un titre descriptif
- Un résumé
- Étapes à reproduire
- Comportement attendu
- Contexte (OS, Navigateur, etc.)
Pensez également à ajouter des captures d'écran si cela peut rendre les choses plus claires.
Il y a beaucoup de bon matériel sur le web au sujet du signalement des bogues :
The resolvepath macro takes a relative path and an absolute path. It interprets the former relative to the latter, and returns the absolute equivalent of the former.
Folders in the paths are delimited by /.
The special folder name . denotes the current folder, and .. denotes the parent folder.
If the absolute path indicates a folder, it needs to end with /. Anything after the final / is treated as an arbitrary filename within the intended path, and is discarded.
If no absolute path is supplied, the relative path is returned unchanged, except that anything after the final / is discarded.
The return value is a path, but does not end with /.
Parameters
- source
- the relative path
- root
- the absolute path
<<resolvepath "./backup" "http://example.com/store.php">><<resolvepath "backup" "http://example.com/store.php">><<resolvepath "../backup" "http://example.com/store.php">><<resolvepath "../jpg/Motovun_Jack.jpg" "http://example.com/resources/images/png/">><<resolvepath "../jpg/../png/Motovun_Jack.png">><<resolvepath "jpg/Motovun_Jack.jpg">>Voici quelques sites contenant des ressources créées par la communauté TiddlyWiki, pour vous aider à tirer le meilleur de TiddlyWiki : plugins, macros etc. N'hésitez pas à proposer de nouvelles ressources via GitHub, Twitter ou en postant sur les groupes de discussion TiddlyWiki.
Code styles and auto format settings for IDEs
https://gitlab.com/bimlas/tw5-code-style-auto-format
Posted il y a 2 mois
Implementation of TiddlyWiki Coding Style Guidelines for different IDEs.
"TiddlyWiki Toolmap" by David Gifford
https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM
Posted il y a 3 mois
A topical index of known plugins, tutorials, themes, and other helpful tools for TiddlyWiki.
https://dynalist.io/d/zUP-nIWu2FFoXH-oM7L7d9DM
Some of the topics indexed so far include:
- Background images and background colors
- Breadcrumbs
- Business - examples
- CSS / Styles, general
- Calendars, dates and timelines
- Checklists
- Collaboration
- Color palettes
- Colors
- Data visualizations
- Developer / advanced tools
- Diplay tiddlers horizontally
- Dropdowns
- Educational
- External files
- Fields
- Fonts
- Fun and games
- Home and lifestyle
- IFrames and embedding media
- Image galleries, modals and lightboxes
- Images, icons, emojis
- Importing and exporting between TiddlyWiki files
- Includes scaffolding within a tiddler, dragging to reorder tiddlers, choosing the number of columns
- Interfacing with, importing and exporting to and from other formats
- Knowledge bases, dictionaries and glossaries
- Layout/UI
- Lightboxes
- Links, linking
- Lists and filters
- Maps and geography
- Masonry, scaffolding
- Math
- MindMapping
- Mobile tools
- Music and sound
- Navigation
- node.js
- Note-taking
- Open the "filter" tab
- Partially hidden tiddlers
- Personal websites (examples)
- Presentations and slideshows
- Printing
- Project management
- Publishing and hosting TiddlyWikis on the web
- Searching tools
- Security and backup tools
- Social media, sharing, comments
- Spreadsheets and math
- Startup
- Sticky titles
- Story and screenplay creation
- Table of contents
- Tables, charts and graphs (cf data visualizations)
- Tabs
- Tags, tagging
- Task management and productivity - to do lists
- Themes
- Understanding TiddlyWiki
- Writing and editing
Timimi
https://github.com/ibnishak/Timimi
Posted il y a 3 mois
Timimi is a Web Extension and executable for Firefox, Chrome and Chromium that allows it to save standalone TiddlyWiki files.
https://github.com/ibnishak/Timimi
This is an addon using native messaging, essentially handing over the contents to a webextension host (executable) which does the actual saving. Once installed, you can save the standalone TW from anywhere in your hard drive without any more interactions, like the original Tiddlyfox addon.
TW5-SingleExecutable by Jed Carty
https://github.com/OokTech/TW5-SingleExecutable
Posted il y a 10 mois
TiddlyWiki5 Packaged with the multi-user plugin in a single executable file.
https://github.com/OokTech/TW5-SingleExecutable
Tiddlywiki, node js, multiuser plugin - all packaged into a single file so user can just download the file and run it and not have to install anything else. Versions available for windows, osx, and linux.
Widdly by Opennota
https://github.com/opennota/widdly
Posted il y a 10 mois
A cross platform server application that can save tiddlers to a local database
https://github.com/opennota/widdly
a minimal self-hosted app, written in Go, that can serve as a backend for a personal TiddlyWiki.
"Dynamic Tables" by Jed Carty
http://ooktech.com/jed/ExampleWikis/DynamicTables/
Posted il y a 10 mois
Dynamic Tables is a set of macros that allow you to create tables where the rows are created from tiddlers and the columns from the tiddler fields, or where the columns are created from tiddlers and the rows from their fields. Individual cells can be edited on the fly. Row tables can be sorted by columns and column tables can be sorted by rows.
"ATWiki" by Lamusia Project
https://lamusia.github.io/#ATWiki
Posted il y a 13 mois
A desktop application for TiddlyWiki, running on Windows.
https://lamusia.github.io/#ATWiki
TiddlyWiki for Windows. A unique non-linear notebook for capturing, organising and sharing complex information.
"muritest" by Simon Huber
http://muritest.tiddlyspot.com
Posted il y a 13 mois
A terrific demo of drag and drop, pan and zoom, and other sophisticated touch effects. Based on the muuri plugin by Uwe Stuehler.
Plugins by Uwe Stuehler
https://ustuehler.github.io
Posted il y a 13 mois
A collection of plugins from Uwe Stuehler, including:
- Material Edition, a theme based on Google's "material" design language
- A wrapper for the MUURI plugin, bringing complex "masonry"-style layouts to TiddlyWiki
file-backups
https://github.com/pmario/file-backups
Posted il y a 14 mois
An extension for Mozilla Firefox that smoothes out some of the friction from TiddlyWiki's built-in HTML5 fallback saver, making it almost as easy to use as TiddlyFox. The workflow is intended to work out of the box, without configuration.
https://github.com/pmario/file-backups which contains links to the documentation and introduction video(s).
A chrome version is planned!
"Tekan: Kanban that stays with you" by Riz
https://ibnishak.github.io/Tesseract/projects/tekan/Tekan.html
Posted il y a 14 mois
A Kanban implementation for TiddlyWiki with a familiar look and feel (see the demo).
https://ibnishak.github.io/Tesseract/projects/tekan/Tekan.html
This is Tekan, a TW based kanban. The easiest way to know tekan is to use it. So let us begin, shall we?
"X3DOM for TiddlyWiki 5" by Jamal Wills
http://x3dom.tiddlyspot.com/
Posted il y a 14 mois
An experiment to embed interactive 3D graphics within TiddlyWiki by Jamal Wills. It is based X3DOM, an open source JavaScript library.
~TiddlyServer
https://github.com/Arlen22/TiddlyServer
Posted il y a 14 mois
An extension to the Node.js configuration of TiddlyWiki that adds support for static attachments and for working with multiple wikis at the same time.
https://github.com/Arlen22/TiddlyServer
TiddlyServer 2.0 takes the server command of TiddlyWiki on NodeJS and adds it to a static file server. This means you can load and serve any TiddlyWiki data folder in the same way you can serve a single file TiddlyWiki.
But you don't need to serve files and folders from just one place, you can serve them from multiple places anywhere on your harddrive (literally anywhere NodeJS can stat, readdir, and readFile). You can even organize them into virtual folders (aka aliases in Apache and mounts in Express).
The main point, of course, is that you can actually edit your files, not just look at them. Single file TiddlyWikis use the put saver, which needs to be patched using a bookmarklet included on the index page. The instructions for this are below under the heading "One thing that needs to be noted".
And, of course, you can edit data folder tiddlywikis just like you were running node tiddlywiki.js data –server, except that you run it on the path that you found it at (e.g. http://localhost/personal/notes/). You can have as many data folders open as you want, they don't conflict (though they will each take memory).
Data folders store individual tiddlers instead of entire wikis. They take less disk space as they also do not store the core and plugins. This means they also save much quicker, especially over the internet. They also save immediately (within 10 seconds or so) and they save drafts.
~TiddlyDrive
https://chrome.google.com/webstore/detail/tiddly-drive/oaphhjhbbabdjnpjpiliepphpmnioolo
Posted il y a 14 mois
An add-on for Google Drive that allows TiddlyWiki files stored there to be opened and saved directly
https://chrome.google.com/webstore/detail/tiddly-drive/oaphhjhbbabdjnpjpiliepphpmnioolo
I made an app that lets one edit TiddlyWiki files saved in your Google drive and then saving them back automagically. The page is here https://chrome.google.com/webstore/detail/tiddly-drive/oaphhjhbbabdjnpjpiliepphpmnioolo but I think you need to add it from the Google Drive web interface.
I even added an optional ability to save with ctrl + s hotkeys.
Joshua's launch post
Noteself
https://noteself.github.io/
Posted il y a 14 mois
NoteSelf is your personal, private, customizable, Evernote-like experience. You want cloud? Fine! You don't? Fine too! It's all yours, It's your decision! Why not be a bit selfish?
NoteSelf is the perfect place to store your ideas, notes, thoughts, tips, tricks, recipes... whatever you want to put into it! NoteSelf will store, index, and make it easily searchable, so you will find it instantly whenever you need it!
You already know and love Evernote, we know it. It is comfortable, it syncs, has search capabilities... Wow, it's almost perfect, but what about:
- Privacy - Everything is stored on the Evernote's servers!
- Customization - If you don't like the interface of Evernote, there's nothing you can do
NoteSelf is built on top of TiddlyWiki, a powerful, free, highly customizable and open-source personal wiki. We took the best of it, it's powerful customization system, and mixed it with one of the best embedded databases available, PouchDb, for bringing the synchronization capabilities you need.
savetiddlers
https://github.com/buggyj/savetiddlers
Posted il y a 14 mois
An extension for Google Chrome and Mozilla Firefox that smoothes out some of the friction from TiddlyWiki's built-in HTML5 fallback saver, making it almost as easy to use as TiddlyFox once it is set up correctly.
"Dropboard" by Reid Gould
https://github.com/reidgould/tiddlywiki-dropboard
Posted il y a 14 mois
A TiddlyWiki plugin for kanban-like organization in the style of Trello™ using boards, lists, and cards.
Full Text Search Plugin by Rob Hoelz
https://hoelz.ro/files/fts.html
Posted il y a 14 mois
A plugin to integrate the popular lunr.js search engine, giving TiddlyWiki much more sophisticated search capabilities:
https://hoelz.ro/files/fts.html
Provides an alternative search result list that orders results by search relevance and ignores differences in word forms (ex. tag vs tags).
On my personal wiki, I have the problem that there are terms I use across a lot of tiddlers, and sometimes I'll use different forms (such as the aforementioned tag vs tags). I wanted a plugin to allow me to find the tiddler I'm looking for quickly and didn't require me to worry about how I declined a noun or inflected a verb - so I wrote this plugin, which provides an alternative search list powered by lunr.js.
"JD Mobile Layout plugin" by JD
http://j.d.simplemobile.tiddlyspot.com
Posted il y a 14 mois
A plugin that improves the usability of TiddlyWiki on smartphones by JD:
"MathCell" by Stephen Kimmel
http://mathcell.tiddlyspot.com/
Posted il y a 17 mois
Mathcell allows spreadsheet-like abilities in a completely contained TiddlyWiki.
http://mathcell.tiddlyspot.com/
Mathcell allows spreadsheet-like abilities in a completely contained TiddlyWiki. Additional abilities allow it work as a general math engine.
"Wikilabs" by PMario
https://wikilabs.github.io
Posted il y a 21 mois
A collection of references for testing concepts around TiddlyWiki 5...
This is PMario's playground with ramblings about TiddlyWiki and related stuff.
It basically is a "jump off" page to various TiddlyWiki sites, that show editions, themes and plugins.
Tinka by Andreas Hahn
https://tinkaplugin.github.io/
Posted il y a 23 mois
The Tinka plugin provides the ability to create and modify plugins in the browser, without requiring the use of Node.js.
See https://github.com/TinkaPlugin/Tinka for the GitHub repo.
https://tinkaplugin.github.io/
This is a Control Panel extension that aims to simplify the plugin creation and editing process. After installing, you will find a new tab in your control panel that makes creating and modifying plugins a little bit easier.
Leaflet maps plugin by Sylvain Comte
http://sycom.github.io/TiddlyWiki-Plugins/#Leaflet%20plugin
Posted il y a 2 ans
A mapping plugin based on Leaflet library. Allows you to create maps based upon geographical data contained in tiddlers.
http://sycom.github.io/TiddlyWiki-Plugins/#Leaflet%20plugin
The leaflet plugin is a (working) attempt to integrate the leaflet library in TiddlyWiki in order to display geographical purpose tiddlers.
For now
<$leafmap>widget displays an interactive map. Select size, location and zoom, clustering distance, and background. You can display data : geojson, point(s), polygon(s) and/or polyline(s) directly or calling GeoTiddler(s). Tiddler can be called individually, by list or with a filter.Have a look at demo page on the web.
"Slides and Stories" by Jan
http://slidesnstories.tiddlyspot.com
Posted il y a 2 ans
Slides and Stories is a repository of the tools to optimize TW for scientific research and for presenting and publishing results.
http://slidesnstories.tiddlyspot.com
SlidesnStories
...is a tool to save and reload sets of Tiddlers. This is already working, The aim is to develop a mechanism to transform these into instant slideshows.
MetaTabs
is a tool which gives you the possibility to attach and show specific information in tabs at the bottom of each Tiddler: ideas, notes, tasks, stories and presentations, comments, annotations and footnotes.
It is inspired by MagicTabs and Tiddlyscholar by Alberto Molina Pérez, which are very elaborated tools that alas do not seem to be in active development any more. I wanted to change the behaviour in some ways. For example I wanted show tabs only if they have content....furthermore there is
- an export-plugin,
- a footnote-plugin,
- and a plugin to rearrange Tiddlers in the StoryRiver
"TiddlyWiki Knowledge Network" by Dmitry Sokolov
http://confocal-manawatu.pbworks.com/w/page/113574373/TiddlyWiki
Posted il y a 2 ans
A Knowledge Network about TiddlyWiki.
http://confocal-manawatu.pbworks.com/w/page/113574373/TiddlyWiki
Interconnected with the visual taxonomy at every node: http://debategraph.org/Stream.aspx?nid=457381&vt=bubble&dc=focus
TWKN will be transferred into TWederation/TiddlyMap format as soon as I am convinced in reliable and secure versioning and multi-user operation in TW format. Your assistance and support would be highly appreciated.
"Cardo - Task and Project Management Wiki" by David Szego
http://cardo.wiki
Posted il y a 2 ans
Task & Delegation Tracking, Meetings & Agenda Items, Project Roles, Progress & Status Updates, Reference Items, Tickler Calendar, Conversation Logging, Book Notes & Library, and More!
Cardo is a standalone, browser-based tool that can be used as a simple task manager, or as a complex Project Management system (and indeed, I do use it this way in my daily work) as well as a fully Wiki-ized personal knowledge store. It runs completely independently in the browser, even without an Internet connection, making it possible to carry around on a USB stick, or to use on the morning commute.
"TB5 - a pocket full of tips" by Tobias Beer
http://tobibeer.github.io/tb5/
Posted il y a 2 ans
An enormous collection of tips beautifully curated by Tobias Beer. It is actually a collection of sites, with sub-sites dedicated to topics such as filtering (http://tobibeer.github.io/tw/filters/).
http://tobibeer.github.io/tb5/
A collection of references and sandbox for testing concepts around TiddlyWiki 5...
"TiddlyServer" by Matt Lauber
https://github.com/mklauber/TiddlyServer/releases/
Posted il y a 2 ans
TiddlyServer is a special purpose Desktop app, designed to facilitate managing multiple instances of TiddlyWiki running as a server. It does not require internet acess to access the wikis.
https://github.com/mklauber/TiddlyServer/releases/
TiddlyServer can import both TiddlyWiki files and TiddlyFolder wikis. For each wiki, you specify a prefix to serve it with and the source to import from. It will copy the wikis to its own internal store and begin serving them up at http://localhost:8080/{prefix}/. The export button for each wiki will convert it to a single file wiki.
"Hacks" by Thomas Elmiger
http://tid.li/tw5/hacks.html
Posted il y a 2 ans
A collection of helpers by Thomas Elmiger, among them a tweet button macro, a text-stretch solution, a snippet extraction macro and a tiddler that installs a scroll-to-top button via drag-and-drop.
Quick Extensions for TiddlyWiki 5 – […] As I take from the community, I am happy if I can give back. You can use my stuff to do whatever you like, but remember to save a back-up first.
Thomas
"Ghostwriter theme by Rory Gibson" adapted for TW5 by Riz
https://ibnishak.github.io/ghostwriter/
Posted il y a 2 ans
An adaption of the "Ghostwriter" theme for TiddlyWiki.
https://ibnishak.github.io/ghostwriter/
Ghostwriter is a popular, minimalist and mobile responsive theme for the blogging platform ghost. This is an adaptation for TiddlyWiki.
"TiddlyWiki5 Forum on Reddit" by Riz
https://www.reddit.com/r/TiddlyWiki5/
Posted il y a 2 ans
A TiddlyWiki5 forum on Reddit.
https://www.reddit.com/r/TiddlyWiki5/
A TiddlyWiki5 forum on Reddit. As of 2016, it claims to have the most up-to-date list of plugins available for TW5.
"Moments: A little color won't hurt" by Riz
http://tesseractmoments.surge.sh/
Posted il y a 2 ans
An adaption of the "Moments" theme for TiddlyWiki.
http://tesseractmoments.surge.sh/
Moments is a beautiful free and responsive theme available for wordpress from here: http://www.s5themes.com/theme/moments/. This is an adaptation of the same for TW5 platform. All the design credits goes to the site and the original designer. If TW5 is going to be here for 25 years, might as well suit up.
"How Does Twederation Work" by Jed Carty
http://twederation.tiddlyspot.com/#How%20does%20the%20TWederation%20work%20anyway%3F%20-%20The%20TWederation%20(2016122014h0034)
Posted il y a 2 ans
An explainer about Twederation, a system of sharing information between TiddlyWiki instances.
TWederation is a system for sharing information between participating TiddlyWikis without using a client-server model. The link here points to a tiddler that gives more details. This particular implementation works something like an online forum. On the rest of the site, you can follow discussions by the developers and collaborators occurring within the Twederation "network" itself.
"Gospel Bubbles" by Rev. David Gifford
http://giffmex.org/gospels.bubbles.html#Gospels%20Bubbles
Posted il y a 2 ans
Creates bubble maps of Biblical texts.
http://giffmex.org/gospels.bubbles.html#Gospels%20Bubbles
This TiddlyWiki, which is still under construction, has several features that together make it lightning fast to find passages, types of passages, themes, people, places and images in the New Testament Gospels. The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
- The bubblemaps are color-coded overviews of each Gospel. Each type of passage (miracle story, parable, etc) was assigned a color. Bubblemaps allow you to do three things:
- See how the different types of passages are distributed throughout each Gospel.
- Hover over passages to see the verses and titles.
- Click on a passage to open it and see the themes and other data it mentions.
- The themes by passage indexes are lists of the passages in each Gospel, followed by the themes and other data found in the passage. Clicking on a theme calls up a list of all the passages that mention that theme.
- The indexes of themes contain lists of links to each theme, person, group, place and image. Clicking on a theme calls up a list of all the passages that mention that theme.
- There is a search window hidden in the right hand menu. Use the search window to find passages quickly, by typing things like sower or paralytic. Click the arrows in the upper right of the screen to open the menu and search.
"Filter Examples" by Tobias Beer
http://tobibeer.github.io/tw/filters/#Filter%20Examples
Posted il y a 2 ans
This wiki gives examples for various filters and their use in the list widget
http://tobibeer.github.io/tw/filters/#Filter%20Examples
This wiki gives examples for various filters and their use in the list widget. A good starting point to understand what filters yield which results also is test-filters.js.
"Lucky Sushi" online shop by sini-Kit
http://luckysushi.ru/habarovsk/heeg35.html#index
Posted il y a 2 ans
A complete online shop made in TiddlyWiki!
TiddlyWiki extensions for ViM
https://github.com/roma0104/vim-tid
Posted il y a 2 ans
Vi iMproved syntax file for TiddlyWiki5 *.tid files.
"SK Plugins" by Stephen Kimmel
http://skplugins.tiddlyspot.com/
Posted il y a 2 ans
A collection of plugins by Stephen Kimmel, including a number of additional editor toolbar buttons.
http://skplugins.tiddlyspot.com/
In keeping with the general spirit of the TiddlyWiki community, ie, you develop something useful and/or potentially interesting you share it with others, I'm sharing some of the plugins I've developed to go with the new Editor Toolbar. You'll find them and a more extensive discussion of what each does at http://skplugins.tiddlyspot.com/
"Mal's Sandbox" by Mal
http://malsandbox.tiddlyspot.com
Posted il y a 2 ans
A collection of extensions by @malgam
http://malsandbox.tiddlyspot.com
The "loadnew" plugin provides the JavaScript module $:/plugins/malgam/loadnew/loadnew.js that implements an incremental load command for Tiddlywiki 5.
The javascript code is based on the built-in module $:/core/modules/commands/load.js that loads tiddlers from a Tiddlywiki file into a node.js Tiddlywiki instance. This command loads all non-system tiddlers, irrespective of whether they have been modified since last loaded. As a result, all tiddlers in the node.js tiddlers folder will end up with a new modification date.
In contrast, the loadnew command only loads tiddlers that either don't already exist in the tiddlers folder, or have a newer modified date than the existing tiddler.
With a backup strategy that uses a file system snapshot process to preserve historical versions of tiddlers, the loadnew command minimises the sizes of the resulting snapshots.
twproxy by Steve Gattuso
https://github.com/stevenleeg/twproxy
Posted il y a 2 ans
An authentication proxy for your TiddlyWiki.
https://github.com/stevenleeg/twproxy
One of my favorite aspects of TiddlyWiki has been that it's web-based, making it possible for me to access my wiki from everywhere (especially my phone). That being said, I'm a bit paranoid, so I was left a bit unsatisfied with the tiddlywiki server's HTTP basic auth for protecting my wiki. ~23 commits later, I've created something called twproxy that I'd like to share with you all today, as I'm hoping somebody other than myself will find it useful.
Essentially it is a simple proxy that puts your wiki behind a username, password, and optional 2-factor auth prompt. This gives you added security in addition to the ability to remember your credentials past one browsing session (I was getting sick and tired of typing my username/password in over and over using basic auth).
TiddlyWiki extensions for Sublime Text 3 by roma0104
https://github.com/roma0104/sublime-tid
Posted il y a 2 ans
Sublime Text 3 syntax file for TiddlyWiki5 *.tid files.
TiddlyChrome by Arlen Beiler
https://github.com/Arlen22/tiddly-chrome-app/
Posted il y a 2 ans
An extension application for Google Chrome that enables TiddlyWiki to save changes directly to the file system.
datepicker plugin based on Pikaday, by kixam
http://kixam.github.io/TW5-datePicker/
Posted il y a 3 ans
An interactive date picker plugin based on Pikaday. A demo can be found here: http://kixam.github.io/TW5-datePicker/.
datepicker is a TiddlyWiki plugin that allows you to use a widget much like EditTextWidget to pick a date, and optionaly a time. It shows a nice interactive mini-calendar when clicked, allows you to set a date format for display, and is compatible with core date fields such as
modifiedandcreated.
TiddlyWiki Video Tutorials by Francis Meetze
https://www.youtube.com/playlist?list=PLzZCajspPU_UjFn0uy-J9URz0LP4zhxRK
Posted il y a 3 ans
An extensive tutorial for getting started with TiddlyWiki. Recommended
https://www.youtube.com/playlist?list=PLzZCajspPU_UjFn0uy-J9URz0LP4zhxRK
This tutorial is aimed at giving you a basic foundation so that you can start using TiddlyWiki right away. Here we take a look at the technology behind Tiddlywiki, how to install it and create your first Tiddler.
TWCommunitySearch
http://erwanm.github.io/tw-community-search
Posted il y a 3 ans
The CommunitySearch wiki aggregates many public wikis from the community. It is updated automatically every day. At the time of writing, more than 5000 tiddlers are indexed, thus giving access to the largest known collection of TW content.
It lets you search for some specific content among a preselected list of wikis. The indexed content is mostly focused on TW usage, so you would typically use this search system to find information about a particular aspect of TiddlyWiki. Say for example that you want to learn how to make a table of content, type "table of content" in the CommunitySearch box (also accessible in the default tiddler GettingStarted). The search results are links to various wikis, and point directly to the specific tiddlers containing your request.
The CommunitySearch wiki also lets you:
- Browse the list of wikis
- Browse the list of author
- Browse the list of plugins
- Access content by tag (see also BookmarkingTags)
- Follow the latest news from the community (and publish your own news if you are a wiki author)
TiddlyWiki Jingle by Måns Mårtensson
https://musescore.com/node/796056
Posted il y a 3 ans
A catchy jingle for TiddlyWiki.
https://musescore.com/node/796056
Even if it sounds like some ol' jazz tune it IS an original composition and it should be quite obvious that the "hook of the melody" is a trill made by singing Tidd-ly Wiki :-).
My lacking skills for writing text/lyrics should be apparent in the fact that the text consists of 12 Tidd-ly Wikis and some extra "tiddly's" - just for the sake of getting the message delivered ;-)...
I've recorded every instrument on my guitar via a guitar synth on a loop machine (except for the drums - they were played live/in sync with the loop station on a "BeatBuddy" drum pedal..) - no pc was involved..
rboue's plugins for TiddlyWiki
http://rboue.tiddlyspot.com
Posted il y a 3 ans
Featuring plugins that integrate two interesting new capabilities:
- SocialCalc providing a powerful spreadsheet
- Three.js providing interactive 3D graphics
I developed some plugins related to engineering tasks.
After using them for personal projects I'm glad to share with TiddlyWiki community.
"Encrypt single tiddler plugin" by Danielo Rodriguez
http://danielorodriguez.com/TW5-EncryptTiddlerPlugin/
Posted il y a 3 ans
A plugin that allows to encrypt your tiddlers individually Danielo Rodriguez.
http://danielorodriguez.com/TW5-EncryptTiddlerPlugin/
Advantages:
- You can specify a different password for each tiddler if you want.
- You don't have to encrypt your whole wiky.
- If you forget your password, you only lose a tiddler.
- It's possible to edit the tiddler content , tags and fields except the encrypt field after encryption.
- [...]
"TiddlyWiki for Scholars" by Alberto Molina
http://tw5.scholars.tiddlyspot.com/
Posted il y a 3 ans
Une version préliminaire d'une édition de TiddlyWiki adaptée à la prise de notes universitaire.
http://tw5.scholars.tiddlyspot.com/
TiddlyWiki for Scholars est une personnalisation de TiddlyWiki 5.0.13-beta, que j'ai écrite en pensant à la prise de notes à partir de lectures, mais qui peut servir à d'autres choses. L'idée est de montrer et de faciliter la création des données liées au tiddler courant sans quitter le tiddler.
TWaddle by Matias Goldman
http://twaddle.tiddlyspot.com/
Posted il y a 3 ans
A collection of hints and tips, musings and proposals from long-time TiddlyWiki contributor Mat Goldman.
http://twaddle.tiddlyspot.com/
This is Mat's, a.k.a <:-) little man-cave in the TiddlyVerse.
Most TW development is, understandably, based on the premise that "Improve code ➔ Better TW". TWaddle is also about developing TW but from the perspective that Bigger community ⇄ Better TW. Thus, TWaddle looks more to people issues - how to attract them, how to make them stick with TW etc.
I'm not a programmer but I am a TW enthusiast so I tiddlefiddle enough to make the occasional discovery of something cool. Given the amount of words I utter, it is also a mere numbers game before I say something that makes sense. TWaddle is intended to capture these eventualities.
vis.js Timeline by emkay, revived by kixam
http://kixam.github.io/TW5-visjsTimeline/
Posted il y a 3 ans
An interactive timeline visualisation plugin based on Vis.js. A demo can be found here: http://kixam.github.io/TW5-visjsTimeline/.
vis.js Timeline is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable timelines. This project is a direct continuation of emkay's plugin.
SeeAlso by Matias Goldman
http://seealso.tiddlyspot.com
Posted il y a 3 ans
A simple technique for adding tag-based cross references to the default view template.
See also: - is a feature to generate a "See also:" section after the tiddler text, somewhat like in Wikipedia articles.
Ace Editor Plugin by Joerg Plewe
http://innoq.tiddlyspot.com
Posted il y a 3 ans
A plugin to integrate the Ace editor into TiddlyWiki.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
IndexedDB Plugin by Andreas Abeck
http://tw5-dev.cibm.de
Posted il y a 3 ans
A plugin that allows changes to be synchronised with the IndexedDB database that is built-in to most browsers.
Being quite new to TW5 development I tried my best to draft a SyncAdaptor to store tiddlers in IndexedDb. This is quite useful if an application / plugin installation is not possible (we have quite some restrictions at work...).
"TW5-TeXZilla" plugin by Joe Renes
http://tw5-texzilla.tiddlyspot.com
Posted il y a 3 ans
An alternative LaTeX plugin for TiddlyWiki5. It supports a wider set of LaTeX commands than KaTeX, though not as extensive as MathJax
http://tw5-texzilla.tiddlyspot.com
This plugin provides LaTeX support in TiddlyWiki5, using the TeXZilla latex parser to generate MathML.
Only Firefox and Safari support MathML at the moment, so the plugin is only useful if you're using one of these browsers. It might be possible to combine this plugin with MathJax to convert MathML to something that other browsers can understand, e.g. HTML+CSS, but I haven't tried this.
"GSD5" by Roma Hicks
http://gsd5.tiddlyspot.com/
Posted il y a 4 ans
An adaptation of the TiddlyWiki powered GTD® system formerly known as MonkeyGTD for TiddlyWiki version 5.
GSD5 is a Getting-Thing-Done tool for TiddlyWiki5 based off the mGSD classic TiddlyWiki.
"Heeg.ru" by sini-Kit
http://heeg.ru/
Posted il y a 4 ans
A guide in Russian to creating an online shop with TiddlyWiki. No serverside code is needed, instead orders are handled by Disqus.
"In My Socks" by Jed Carty
http://inmysocks.tiddlyspot.com
Posted il y a 4 ans
An extensive collection of hints and tips from Jed Carty.
http://inmysocks.tiddlyspot.com
I made this so that some of my friends with absolutely no coding experience could use some of the better features of TW5 without having to learn much. I am hopefully going to continue updating it as I learn new things. There isn't really anything here that isn't available in plenty of other places, but I figured that since I spent a while putting it together and people keep saying that TW needs more documentation I would post it here.
TiddlyMap Plugin by Felix Küppers
http://tiddlymap.org
Posted il y a 4 ans
An interactive network visualisation plugin based on Vis.js. A demo that also contains installation instructions can be found here: http://tiddlymap.org. The plugin's GitHub repository can be found here.
TiddlyMap is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable graphs. By creating relations between your topics you can easily do the following:
- Create concept maps and quickly manifest your ideas in tiddlers.
- Create task-dependency graphs to organize and describe your tasks.
- Visualize your topic structures to get an immediate grasp of topics and relations.
In general you may create, visualize and describe any network-structure you have in mind.
"Briefcase" by Roma Hicks
http://gsd5.tiddlyspot.com/
Posted il y a 4 ans
Une adaptation pour TiddlyWiki version 5 du système GTD® adapté pour TiddlyWiki, connu précédemment sous le nom de MonkeyGTD.
Briefcase est un outil Getting-Thing-Done pour TiddlyWiki5 basé sur le mGSD classique pour TiddlyWiki.
"CouchDB Adaptor" by William Shallum
https://github.com/wshallum/couchadaptor
Posted il y a 4 ans
Un adaptateur qui permet à TiddlyWiki de synchroniser les modifications avec une base de données CouchDB.
L'adaptateur CouchDB pour TiddlyWiki 5. Nécessite une version de TiddlyWiki >= 5.1.2.
Fonctionne après des tests limités. Difficile de garantir qu'il gère les conflits correctement.
"TiddlyWiki guide FR" by Sylvain Naudin
http://sylvain.naud.in/public/TiddlyWiki/tiddlywiki-guide-fr-CCbysa.html
Posted il y a 4 ans
Une collection de trucs et astuces en Français, introduits par ce post de blog :
http://sylvain.naud.in/post/2014/10/29/Ressources-pour-TiddlyWiki-5-%28FR%29
Ce guide de prise en main de TiddlyWiki vous permettra de débuter sur ce logiciel : rédiger du texte avec la syntaxe wiki, insérer des images, créer des Tiddler, faire une recherche, ajouter des fonctionnalités, et bien d'autres choses.. Bonne lecture ! Sylvain
"TiddlyWiki5 Bourbon" by mkt_memory
http://bacchus.ivory.ne.jp/bourbon/
Posted il y a 4 ans
Une collection importante de trucs et ressources pour les utilisateurs de TiddlyWiki en Japonais.
TiddlyWikiをHTML5にしたTiddlyWiki5が正式にリリースされました。このTiddlyWiki5の使い方について、自分で試した機能を中心に解説します。
TiddlyWiki5は、非常に多機能なローカルWikiです。このブログに書いてあることは、TiddlyWiki5で出来ることのごく一部です。
"BJTools" by buggyj
http://bjtools.tiddlyspot.com
Posted il y a 4 ans
buggyj a créé plusieurs plugins utiles, notamment un éditeur HTML WYSIWYG, un calendrier configurable et des listes de tags réagençables par simple glisser-déplacer.
"BrainTest - tools for a digital brain" by Danielo Rodriguez
http://braintest.tiddlyspot.com/
Posted il y a 4 ans
Une collection de diverses personnalisations et macros, par Danielo Rodriguez.
Ceci est mon fichier tiddlywiki de test personnel.
Ici, je posterai les outils et macros que je développe pour ce merveilleux outil. Ainsi, toute l'aide que j'ai reçue de la communauté retourne à la communauté.
"TiddlyWiki5^2 documenting while learning TiddlyWiki5" by Iannis Zannos
http://larigot.avarts.ionio.gr/users/iani/wikis/tw5square.html
Posted il y a 4 ans
A wealth of hints, tips and notes about using TiddlyWiki on Node.js:
http://larigot.avarts.ionio.gr/users/iani/wikis/tw5square.html
TiddlyWiki is different from other wikis because of its principle of dynamically customizeable "storyline" based on tiddlers as basic units of information. That is, the user "composes" their own version of the webpage by clicking on tiddler links, which add tiddlers to the page in order to compose a storyline.
The Node.js implementation in TiddlyWiki5 adds all the advantages of flat-file markup language based type of site. This makes TiddlyWiki an excellent alternative to flat-file based CMS/webpage/blog authoring systems for the web.
Also very cool is the treatment of tags as menus everywhere.
Eucaly's Tiddly World
http://eucaly-tw5.tiddlyspot.com/
Posted il y a 4 ans
I collect my tw5 creations on-line as http://eucaly-tw5.tiddlyspot.com/
Available Plugins :
- TitleMe - Return in-place tiddler title, to link / show / edit the source tiddler
- QuickJump - Quick jump to tiddlers in story list
- FlexWidth - Flexibly tweak sidebar width for TiddlyWiki 5 (Inspired by TW5 tristate Sidebar)
- MatchFilter - returns matching text instead of a list of the tiddlers from FieldFilter
- PopupTagger - TagBar / TagTable with popup list of tags (Inspired by MonkeyTaggerMacro for TiddlyWiki classic)
Plugins by TheDiveO
http://thediveo.github.io
Posted il y a 4 ans
A collection of plugins from TheDiveO.
TheDiveO's Third Flow plugin construction system:
The ThirdFlow plugin brings to you another way to develop customization plugins for TiddlyWiki 5. It is not enforcing a specific development flow, it simply tries to help you. Otherwise, it tries to stay out of your way.
TheDiveO's FontAwesome plugin:
The FontAwesome plugin supports embedding Font Awesome in TiddlyWiki 5. There is no need to install this font into your operating system in order to use it with TiddlyWiki 5. The font is already embedded in this TiddlyWiki 5 customization plugin instead, so nothing else to install.
TiddlyClip by buggyjay
http://tiddlyclip.tiddlyspot.com
Posted il y a 4 ans
BuggyJay's TiddlyClip browser extension for Firefox permits clipping of text and graphics from web pages:
http://tiddlyclip.tiddlyspot.com
TiddlyClip allows parts of webpages to be clipped into a TiddlyWiki, and consists of two parts, the browser addon and the TiddlyWiki plugin. The addon is completely memoryless, any configuration is determined by the current TiddlyWiki that the user has select to work with (we say that the addon is docked to the TiddlyWiki). TiddlyClip is designed to work (in a basic mode) without configuration. Once the addon and plugin are installed, all the user has to do is select which TW to dock to.
"Wills Q&D gTD" by Matabele
http://wills.tiddlyspot.com
Posted il y a 4 ans
Matabele's stylish and clean system for personal task management.
This is my work in progress version of TW5, incorporating various features and ideas as and when they intrigue me. To grab any feature you may wish to try, drag the listed tiddlers across to the dropzone of an empty TiddlyWiki 5.0.10-beta
"TWeb.at" by Mario Pietsch
https://tweb.at
Posted il y a 4 ans
A collection of TiddlyWiki resources from Mario Pietsch, with a focus on cloud deployments. Mario also maintains the German translation of TiddlyWiki.
My name is Mario Pietsch from Austria. I'm living near Salzburg.
This page, will be the portal to my TiddlyWiki, TiddlyWeb related content.
MathJax Plugin by Martin Kantor
http://mathjax-tw5.kantorsite.net
Posted il y a 4 ans
An experimental MathJax plugin for TiddlyWiki version 5. As Martin says, the implementation is a bit of a hack but may be useful until we have a better alternative.
http://mathjax-tw5.kantorsite.net
Welcome. I have created plugin for TiddlyWiki 5 which allows you to use MathJax (math in TeX and MathML) inside TiddlyWiki 5. It's unofficial plugin and it doesn't follow general policy of TiddlyWiki as stand-alone solution but it works. So you can use it if you want.
"TiddlyWiki Notes" by James Anderson
http://welford.github.io
Posted il y a 4 ans
Notes and tips by a developer working on writing TiddlyWiki plugins – including TWExe, a widget for running Windows scripts and executables.
"TiddlyWiki 舞" by Bram Chen
http://tw5-zh.tiddlyspot.com
Posted il y a 4 ans
A translation of the tiddlywiki.com documentation from Bram Chen, TiddlyWiki's Chinese translator.
"TW5 Magick" by Stephan Hradek
http://tw5magick.tiddlyspot.com/
Posted il y a 4 ans
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
http://tw5magick.tiddlyspot.com/
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
"Hosting TiddlyWiki5 on GoogleDrive" by Tony Ching
https://googledrive.com/host/0B51gSXixfJ2Qb0I4R2M4MWJVMlU
Posted il y a 4 ans
Tony Ching's quick guide for sharing TiddlyWiki with Google Drive.
https://googledrive.com/host/0B51gSXixfJ2Qb0I4R2M4MWJVMlU
Anyway your self-contained a non-linear personal web notebook can be hosted on Google Drive, a free cloud service from Google.com. Because TiddlyWiki5 now supports the Stanford Javascript Crypto Library (SJCL), you can encrypt your content from prying eyes (excluding the NSA of course)
"TiddlyWiki5 Playground" by Ton Gerner
http://tongerner.tiddlyspot.com/
Posted il y a 4 ans
Huge collection of customisations and tweaks from Ton Gerner.
http://tongerner.tiddlyspot.com/
I am a longtime user of TiddlyWiki Classic and still use it daily since you can't do everything in TiddlyWiki 5 (yet) ;)
I started experimenting with TW5 at the end of September 2013 (alpha10). Since I missed a few things in the layout I got used to in TiddlyWiki Classic 1, I started with modifying the layout of TW5. To share my knowledge, I made a few guides about these 'modifications'. The guides started as a non-linear personal web notebook (yeah, the subtitle of TiddlyWiki!). I started experimenting with layout things and used TW5 to document my experiments.
"TiddlyWiki5 Coding" by Chris Hunt
http://cjhunt.github.io/
Posted il y a 4 ans
Chris Hunt's detailed developer tutorials for getting started with writing widgets for TiddlyWiki.
These pages document aspects TiddlyWiki5 programming, sharing "lessons learned" to help developers to get started with TiddlyWiki5 customization and extension.
There are currently two articles in this wiki:
- A Simple Widget
- A More Complex Widget
"TiddlyWiki Posts" by Jeffrey Kishner
http://blog.jeffreykishner.com/tiddlywiki/
Posted il y a 5 ans
A collection of articles covering integration with Fargo, Font Awesome and Google Calendar, and tips for managing task lists.
http://blog.jeffreykishner.com/tiddlywiki/
I have become a regular user of TiddlyWiki and have become so accustomed to using Font Awesome icons in Fargo that I wanted to incorporate the icons into my wikis as well.
| purpose | discard the first N input titles |
|---|---|
| input | a selection of titles |
| parameter | N = an integer, defaulting to 1 |
| output | all but the first N input titles |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]rest[]]
[list[Days of the Week]rest[3]]
Z Y X W V U T S R Q P O +[rest[5]]
The Résumé Builder edition of TiddlyWiki gets you started with a simple way to create a professional resume that you can save to the web or print.
127.0.0.1
25 janvier 2015 à 18h6
Introduction
The reveal widget hides or shows its content depending upon the value of a state tiddler. The type of the widget determines the condition for the content being displayed:
- type=match: the content is displayed if the state tiddler matches a specified value
- type=nomatch: the content is displayed if the state tiddler doesn't match a specified value
- type=popup: the content is displayed as a popup as described in the PopupMechanism
Content and Attributes
The content of the <$reveal> widget is displayed according to the rules given above.
| Attribute | Description |
|---|---|
| state | The title of the tiddler containing the state |
| type | The type of matching performed: match, nomatch or popup |
| text | The text to match when the type is match and nomatch |
| position | The position used for the popup when the type is popup. Can be left, above, aboveright, right, belowleft or below |
| default | Default value to use when the state tiddler is missing |
| animate | Set to "yes" to animate opening and closure (defaults to "no") |
| retain | Set to "yes" to force the content to be retained even when hidden (defaults to "no") |
Retaining the content when hidden can give poor performance since the hidden content requires refresh processing even though it is not displayed. On the other hand, the content can be revealed much more quickly. Note that setting animate="yes" will also force retain="yes".
Examples
Simple content reveal
Here's a simple example of showing and hiding content with buttons:
<$button set="$:/state/SampleReveal1" setTo="show">Show me</$button>
<$button set="$:/state/SampleReveal1" setTo="hide">Hide me</$button>
<$reveal type="match" state="$:/state/SampleReveal1" text="show">
! This is the revealed content
And this is some text
</$reveal>Affichera ceci :
"Slider"
A slider appears as a single button that can be used to toggle the display of the contained content.
<$reveal type="nomatch" state="$:/state/SampleReveal2" text="show" animate="yes">
<$button set="$:/state/SampleReveal2" setTo="show">Show me</$button>
</$reveal>
<$reveal type="match" state="$:/state/SampleReveal2" text="show" animate="yes">
<$button set="$:/state/SampleReveal2" setTo="hide">Hide me</$button>
! This is the revealed content
And this is some text
</$reveal>Affichera ceci :
Popup
Here is a simple example of a popup built with the RevealWidget:
<$button popup="$:/SamplePopupState">Pop me up!</$button>
<$reveal type="popup" state="$:/SamplePopupState">
<div class="tc-drop-down">
! This is the popup
And this is some text
</div>
</$reveal>Affichera ceci :
| purpose | reverse the order of the input titles |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | the input, in reverse order |
Même si TiddlyWiki n'est plus en version béta, il y a plusieurs évolutions de prévues pour les mois à venir :
- Remédier aux vestiges de TiddlyWikiClassic
- Un format de fichier TiddlyWiki (pour éviter les noms d'attributs illégaux)
- Des Alias (titres alternatifs pour les tiddlers)
- Chercher et remplacer
- Prise en compte du renommage d'un Tiddler
- Infobulles étendues, incorporant une prévisualisation
- Augmenter les raccourcis clavier
- Accès au clavier étendu dans l'éditeur de texte
- Éditeur de liste par glisser-déposer
- Recherche sélective selon les titres, les contenus ou les champs
- Notation Mathématiques
Se reporter aussi à la liste des problèmes sur GitHub : https://github.com/Jermolene/TiddlyWiki5
Introduction
Le Mode Sans Échec permet de désactiver la plupart des personnalisations de TiddlyWiki. Il est nécessaire car certaines personnalisations incorrectes de TiddlyWiki peuvent le rendre inutilisable. Dans un cas particulier, certaines personnalisations échouaient lors du passage à une nouvelle version du noyau de TiddlyWiki (notamment lors de la version beta).
Activer le Mode Sans Échec
Le Mode Sans Échec est activé en faisant précéder le lien URL de TiddlyWiki dans le navigateur par la chaine #:safe. Par exemple :
Comment fonctionne le Mode Sans Échec
Le Mode Sans Échec déclenche 2 modifications :
- Tous les plugins sont momentanément désactivés. Vous pouvez alors utiliser le control panel pour désactiver des plugins.
- Les tiddlers qui modifient les tiddlers shadows sont renommés avec le préfixe
SAFE:, ce qui a pour effet de restaurer les tiddlers shadows sous-jacents.
Un tiddler rapport est affiché pour vous permettre d'examiner les tiddlers renommés.
| purpose | filter the input by date |
|---|---|
| input | a selection of titles |
| suffix | F = the name of a date field, defaulting to modified |
| parameter | D = a date, in the format YYYYMMDD |
| output | those input tiddlers in which field F has the value D, ignoring time |
If D is not a valid date, the output is empty.
D may include a time of day, but this is ignored.
[sameday[20140410]]
[sameday:created[20140410]]
This is a Level 1 Heading
This is a paragraph.
This is written as a Level 3 heading
This is written as a Level 4 heading
This is written as a Level 5 heading
This is a Level 2 heading
This is written as a Level 4 heading
This is written as a Level 5 heading
This is written as a Level 6 heading
This is written as a Level 3 heading
This is written as a Level 4 heading
This is written as a Level 5 heading
This is written as a Level 4 heading
This is written as a Level 5 heading
This is written as a Level 6 heading
This is a demonstration alert.
Note that the trashcan icon deletes the tiddler containing this alert. You can also remove it by opening the tiddler SampleAlert and editing it to remove the tag $:/tags/Alert.
Voici un autre dialogue d'assistant modale, mémorisé dans le tiddler Exemple d'assistant 2.
Vous pouvez .
Enregistre des tiddlers individuels identifiés par un filtre, soit tels quels, soit dans un format binaire dans les fichiers spécifiés.
--save <filtre-des-tiddlers> <filtre-des-noms-de-fichiers>- filtre-des-tiddlers: Un filtre identifiant les tiddlers à enregistrer
- filtre-des-noms-de-fichiers: Filtre optionnel pour transformer les titres de tiddlers en chemins de fichiers. À défaut, le filtre utilisé est
[is[tiddler]], qui utilise le titre inchangé du tiddler comme nom de fichier
Par défaut, le nom de fichier est résolu relativement au sous-répertoire output du réepertoire de l'édition. La commande --output peut servir à diriger les sorties vers un répertoire différent.
Notes :
- Les éventuels fichiers présents dans le répertoire de sortie ne sont pas supprimmés
- Les répertoires absents dans le chemin de fichier sont créés automatiquement.
- Lorsqu'un tiddler contient des espaces dans le titre, prendre garde à utiliser aussi bien les guillemets nécessaires au shell et les doubles crochets droits propres à TiddlyWiki :
--render "[[Motovun Jack.jpg]]" - Le filtre des noms de fichier est évalué après avoir initialisé l'élément d'entrée avec le titre du tiddler en cours d'exécution, permettant ainsi d'utiliser le titre comme base de calcul pour le nom de fichier. Par exemple
[encodeuricomponent[]addprefix[static/]]applique un encodage d'URI à chaque titre, puis ajoute le préfixestatic/ - La commande
--saveremplace de manière plus souple les deux commandes--savetiddleret--savetiddlers, qui sont du même coup obsolètes.
Exemples :
--save "[!is[system]is[image]]" "[encodeuricomponent[]addprefix[tiddlers/]]"– enregistre tous les tiddlers images non-système comme des fichiers du sous-répertoire "tiddlers" nommés après encodage URL des titres.
Enregistre un tiddler texte ou binaire dans le fichier spécifié, sous sa forme brute.
--savetiddler <titre> <chemindufichier>Par défaut, le nom de fichier est résolu relativement au sous-répertoire output du répertoire de l'édition. La commande --output peut servir à rediriger la sortie vers un répertoire différent.
Les répertoires présents dans le chemin du fichier et qui n'existent pas encore sont créés automatiquement.
Enregistre un groupe de tiddlers vers le chemin spécifié, sous leur forme brute, texte ou binaire.
--savetiddlers <filtre> <chemin-de-répertoire> ["noclean"]Par défaut, le répertoire de sortie est calculé relativement au sous-répertoire output du répertoire de l'édition. La commande --output peut servir à diriger la sortie vers un répertoire différent.
Les fichiers présents dans le répertoire de sortie sont supprimés avant que soient enregistrés les fichiers des tiddlers spécifiés par le filtre. Pour empêcher cette suppression, ajouter le drapeau noclean.
Les éventuels répertoires manquants dans le chemin spécifié sont créés automatiquement.
This plugin causes TiddlyWiki to continuously download (as a JSON file) the contents of any tiddler that is manually changed by any of several means:
- Confirming an edit
- Deleting tiddlers
- Imports
- Renames/relinks
- Optionally, typing in draft tiddlers can trigger a download
Where appropriate, separate 'before' and 'after' files are downloaded. Configured correctly, the browser will download the files silently in the background, and they can be used as a backup in case of accidental data loss.
Voici les méthodes disponibles pour sauvegarder vos modifications avec TiddlyWiki :
- TiddlyDrive
- TiddlyServer
- Noteself
- Timimi
- file-backups
- savetiddlers
- TiddlyDesktop
- HTA Hack
- Emergency Export
- Internet Information Services
- Sauvegarder sur Android
- Beaker Browser
- TiddlyDesktop
- Sauvegarder sur Tiddlyspot
- Sauvegarder sur Serveur PHP
- Sauvegarder sur iPad/iPhone
- WebDAV
- Ruby Server
- Sauvegarder avec TiddlyFox sur Android
- Sauvegarder avec TiddlyFox
- Sauvegarder avec l'enregistreur HTML 5 par défaut
- TiddlyWiki Cloud Connectors
- Exporter un sous-ensemble de tiddlers
- Sauvegarder sur Internet Explorer
- Sauvegarder sur Safari
The built-in TiddlySpot saver can also be used pour sauvegarder vos modifications vers un simple script PHP que vous pouvez exécuter sur la plupart des hébergeurs.
These are preliminary instructions that need verification
- Download a copy of store.php from:
- Edit your copy of store.php to add your username(s) and password(s). Find the line
$USERS = array( 'UserName1'=>'Password1', etc)and replace Username1 and Password1 with your desired username and password- Make sure you leave all the punctuation and code, such as the single quotes, intact
- Save the file
- Using FTP or your web interface, upload store.php to your server. Make sure that the filename is correct
- If you've uploaded the file correctly you should be able to view it in your browser (eg, http://example.com/store.php)
- In TiddlyWiki, go to the Saving tab of the control panel and enter the following information:
- Your username as the wiki name
- Your password
- The URL of the store.php file (not the URL of the wiki, this must the full URL to the store.php file)
The control panel Saving tab includes the following configuration options:
| Name | Description |
|---|---|
| Server URL | The full URL to the store.php file on your server |
| Upload filename | The filename used to save the TiddlyWiki (defaults to index.html) |
| Upload directory | The relative path from store.php to the directory used for saving the file |
| Backup directory | The relative path from store.php to the directory used for backups |
L'application AndTidWiki pour les appareils Android permet d'éditer des wikis TiddlyWiki5 et d'enregistrer les modifications, même si vous travaillez sans connexion au réseau. Vous pouvez la télécharger ici.
Notez que AndTidWiki est publiée indépendamment de TiddlyWiki
New in: 5.1.14 TiddlyWiki incorporates a saver module that allows it to save changes directly with the Beaker Browser, an experimental peer-to-peer browser.
Instructions
- Download and install the Beaker Browser from https://beakerbrowser.com/
- Run Beaker, and if necessary open a tab to beaker:start
- Click the "New site" button at the top left of the page
- Enter the details of your site
- Click the link “Add files” and upload your TiddlyWiki index.html file
- View the site by clicking on the link to index.html; it should open in a new tab
- Try out creating tiddlers, and saving changes
At this point, the wiki is entirely private, and other users cannot see the content even if they have the URL. To share the wiki with other users:
- Publish your changes
- Visit the "Library" page in Beaker Browser via the system menu
- Select your site in the list
- Look for a box mentioning "n unpublished changes". If not present, skip to the next step
- Click the "Review changes" button
- Click the "Publish" button
- Share the dat: URL
- Copy the URL of your site from the address bar and share it with other users
- Other users should be able to access your site but they won't be able to make changes unless they fork their own copy
Par défaut, TiddlyWiki enregistre les modifications dans InternetExplorer 10 et au-delà à l'aide d'un module d'enregistrement qui télécharge le fichier nouvellement modifié, plutôt que de l'enregistrer directement. Il existe deux autres options qui enregistrent l'une et l'autre directement les modifications dans le fichier :
- Utiliser l'extension TiddlyIE
- Utiliser le hack Windows HTA en renommant le fichier TiddlyWiki HTML en lui donnant l'extension
*.hta.
L'application TWEdit pour iPad/iPhone permet d'éditer et de sauvegarder des modifications de wikis TiddlyWiki5, même si vous travaillez hors ligne sans connexion réseau. Vous pouvez la télécharger ici.
Instructions d'utilisation :
- Ouvrez TWEdit
- Tapez sur le titre au centre de la barre d'outils
- Une boîte texte doit apparaître dans laquelle vous pouvez saisir une URL
- Entrez l'URL
https://tiddlywiki.com/languages/fr-FR/empty.html - Une fois le TiddlyWiki5 vide chargé, tapez sur l'icône save (il s'agit de la deuxième icône en partant de la droite sur la barre d'outils supérieure)
- Une boîte d'alerte devrait apparaître pour vous permettre d'entrer un nom de fichier local
- Entrez le nom de fichier que vous souhaitez utiliser pour le document (en le suffixant par
.html) - Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Un message de confirmation doit apparaître en haut à droite de la fenêtre
Notez que TWEdit est publié indépendamment de TiddlyWiki
Cette manière d'enregistrer les modifications est assez pénible, car elle requiert une intervention manuelle à chaque enregistrement.
- Téléchargez un TiddlyWiki en cliquant sur ce bouton :
Si le bouton ne fonctionne pas, enregistrez ce lien : https://tiddlywiki.com/languages/fr-FR/empty.html
Votre navigateur vous demandera peut-être d'accepter explicitement l'enregistrement avant qu'il démarre
- Localisez le fichier que vous venez de télécharger
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
.htmlou.htm
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
- Ouvrez le fichier dans Safari
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Une fenêtre popup Enregistrer les modifications s'affiche, avec un lien ayant pour titre Right-click to save changes
- Cliquez-droit sur le lien et choisissez "Télécharger le fichier lié sous..." à partir du menu contextuel
- Naviguez jusqu'au dossier contenant le fichier HTML de votre wiki, et sélectionnez le fichier existant
- Cliquez sur le bouton Enregistrer
- Cliquez sur Remplacer pour confirmer que vous souhaitez remplacer le fichier existant
- Vérifiez que vos modifications ont été correctement enregistrées en ouvrant à nouveau le fichier.
See the Introducing TiddlyDesktop Video
- Install the latest release of TiddlyDesktop from https://github.com/Jermolene/TiddlyDesktop/releases
- Run TiddlyDesktop
- Use the browse button to open TiddlyWiki files
- Save changes within TiddlyWiki in the usual way
TiddlySpot est un service d'hébergement gratuit pour les documents TiddlyWiki, mis à disposition par Simon et Daniel Baird. Le plus simple pour commencer est de créer un nouveau wiki sur http://tiddlyspot.com – par défaut, vous obtiendrez la dernière version de TiddlyWiki Classic.
Vous pouvez publier un document TiddlyWiki depuis votre disque local vers TiddlySpot en suivant les étapes ci-dessous :
- Demandez la création d'un nouveau wiki sur http://tiddlyspot.com/, et rappelez-vous son nom et son mot de passe
- Ouvrez le fichier TiddlyWiki conservé localement dans votre navigateur
- Remplissez le nom et le mot de passe TiddlySpot dans l'onglet Sauvegarde du panneau de contrôle
- Cliquez sur le bouton « Enregistrer les modifications » dans la barre latérale. Vous devriez voir un message de confirmation en haut à droite de la barre latérale indiquant Wiki enregistré. Cela peut durer plusieurs secondes si vous avez une connexion lente ou si vous travaillez avec un wiki volumineux.
- Ouvrez votre wiki TiddlySpot à l'URL
http://<nom-du-wiki>.tiddlyspot.com/
Notez que lorsque vous utilisez TiddlySpot, votre mot de passe est envoyé non-crypté. Extrait de http://faq.tiddlyspot.com/ :
Tiddlyspot est-il sûr ?
Non. Tiddlyspot n'utilise pas SSL/https. Votre mot de passe est envoyé en clair lorsque vous enregistrez votre wiki et au moment où vous vous authentifiez pour accéder à un site privé. Autrement dit, votre Tiddlyspot est ouvert aux renifleurs de paquets et votre mot de passe peut être découvert par un tiers malveillant. De même, vos données sont transmises non -cryptées lorsque vous vous affichez votre site, même s'il s'agit d'un site privé. C'est pourquoi nous vous prions instamment de ne pas conserver d'informations sensibles comme des données bancaires dans votre Tiddlyspot et de ne pas utiliser un mot de passe que vous utilisez pour d'autres sites plus sensibles.
Problèmes lors de la sauvegarde sur Tiddlyspot
Si vous rencontrez l'erreur suivante au moment de déposer un nouveau TiddlyWiki (ou mis à niveau) vers Tiddlyspot à partir d'un fichier local :
Error while saving:
Error:NS_ERROR_DOM_BAD_URI: Access to restricted URI denied
L'opération tombe sous le coup d'une restriction de sécurité propre à Firefox. En attendant que cela puisse être résolu, nous suggérons d'utiliser Chrome pour effectuer cette opération :
- Utilisez Chrome pour ouvrir le document TiddlyWiki local que vous voulez déposer sur TiddlySpot et suivez les étapes 1 à 5 ci-dessus
- Après avoir vérifié que le TiddlyWiki hébergé sur TiddlySpot se chargeait correctement dans Chrome, vous devriez à nouveau pouvoir y accéder, le modifier et l'enregistrer avec TiddlyFox
- Lorsque vous aurez réussi à déposer une première fois votre document local, les modifications et enregistrements suivants de la version en ligne hébergée sur Tiddlyspot devraient fonctionner avec le navigateur récent de votre choix.
- N'oubliez pas de remplir le nom du wiki TiddlySpot et son mot de passe dans l'onglet Sauvegarde de votre panneau de contrôle pour chaque nouveau navigateur que vous souhaitez utiliser pour enregistrer vos modifications.
- Voir aussi : Mise à niveau
This is a minimal server using Ruby Webrick. It just serves up files from the same folder and handles saving.
Once running, just point your web browser at http://localhost:8000 to view the folder listing, and click on your wiki html file.
See the script at:
https://gist.github.com/jimfoltz/ee791c1bdd30ce137bc23cce826096da
If hosted on a WebDAV-enabled server, TiddlyWiki will automatically save changes via HTTP.
Servers
Many NAS or Subversion servers support WebDAV out of the box. Setting up your own server might take some effort though:
dav-server is a quick way to serve up a folder of HTML TiddlyWikis.
webdav server for Android lets you put wikis in your pocket. You can share with other devices on the local network too.
Existing Wikis
WebDAV support was added Feb 16 2016. If you created your wiki before that, you'll need to Upgrade to enable WebDAV.
Video HowTo's
Mario Pietsch has created several videos that show how to prepare Microsoft Internet Information Service (IIS) to host a local TiddlyWiki using WebDav
Free Hosting
Several WebDAV hosting services tested (box.com, swissdisk.com) don't support accessing HTML files via a webbrowser, so they won't work with TiddlyWiki. However, The GMX mediacenter (www.gmx.net) has been reported as working with WebDAV with a free account.
Cette manière d'enregistrer les modifications est assez pénible, car elle requiert une intervention manuelle à chaque enregistrement. Elle a l'avantage de fonctionner avec pratiquement tous les navigateurs tournant sur les ordinateurs de bureaux, et de nombreux navigateurs tournant sur appareils mobiles.
- Téléchargez un TiddlyWiki en cliquant sur ce bouton :
Si le bouton ne fonctionne pas, enregistrez ce lien : https://tiddlywiki.com/languages/fr-FR/empty.html
Votre navigateur vous demandera peut-être d'accepter explicitement l'enregistrement avant qu'il démarre
- Localisez le fichier que vous venez de télécharger
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
.htmlou.htm
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
- Ouvrez le fichier dans votre navigateur
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Votre navigateur téléchargera alors un nouvel exemplaire du wiki, avec vos modifications à l'intérieur
- Localisez ce nouveau fichier et ouvrez-le dans votre navigateur
- Vérifiez que vos modifications ont correctement été enregistrées
Truc: la plupart des navigateurs peuvent être configurés pour proposer un chemin d'enregistrement à chaque téléchargement. Cela vous permet de sélectionner la version précédente du fichier et ainsi de la remplacer.
Si vous utilisez Firefox pour Android, reportez-vous aux instructions pour enregistrer avec TiddlyFox sur Android.
- Assurez-vous d'avoir la dernière version de Firefox
- Installez la dernière version de l'extension TiddlyFox à partir de :
- Redémarrez Firefox
- Téléchargez un TiddlyWiki vide en cliquant sur ce bouton :
- Localisez le fichier que vous venez de télécharger
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
.htmlou.htm
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
- Ouvrez le fichier dans Firefox
- Cliquez OK en réponse à la demande de TiddlyFox d'activer l'enregistrement pour ce fichier
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Attendez l'indication jaune Wiki enregistré en haut à droite de la fenêtre
- Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement enregistrées
(Vous pouvez aussi regarder le tutoriel vidéo).
- Assurez-vous d'avoir installé la dernière version de Firefox pour Android
- Installez la dernière version de l'extension TiddlyFox depuis :
- Installez aussi cette extension qui vous permettra de sauvegarder le fichier TiddlyWiki localement :
- Téléchargez un fichier TiddlyWiki vide en enregistrant ce lien :
(pour enregistrer le lien, assurez-vous d'avoir installé l'extension "save-link-menus", appuyez quelques secondes sur le lien, puis choisissez "Save link")
- Une fois le fichier téléchargé, cliquez dessus depuis la zone de notification ou l'application de gestion des téléchargements
- Choisissez d'ouvrir le fichier avec Firefox (et non l'application par défaut proposée par Android)
- Cliquez OK en réponse à la demande de TiddlyFox qui vous demande s'il faut activer l'enregistrement pour ce fichier
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Entrez du contenu dans le tiddler, puis cliquez sur le bouton terminé
- Sauvegardez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale
- Attendez l'indication jaune Wiki enregistré en haut à droite de la fenêtre
- Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement enregistrées
- Installez l'extension TiddlyIE depuis :
- Redémarrez Internet Explorer. IE vous demandera si vous voulez activer l'extension TiddlyIE.
Il se peut aussi que vous ayez à activer le Microsoft Scripting Runtime
- Téléchargez un TiddlyWiki vide en enregistrant ce lien :
- Localisez le fichier que vous venez de télécharger
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
.htmlou.htm
- Vous pouvez le renommer, mais assurez-vous de conserver l'extension
- Ouvrez le fichier dans Internet Explorer
- Essayez de créer un nouveau tiddler à l'aide du bouton nouveau tiddler de la barre latérale. Ajouter du contenu dans le tiddler, et cliquez sur le bouton terminé
- Enregistrez vos modifications en cliquant sur le bouton enregistrer les modifications de la barre latérale. Internet Explorer vous demandera votre assentiment pour enregistrer le fichier localement en vous présentant un dialogue Enregistrer en tant que.
- Rafraîchissez la fenêtre du navigateur pour vérifier que vos modifications ont été correctement sauvegardées.
The SavingMechanism is the mechanism by which TiddlyWiki generates a new HTML file and stores it. It is different from the sync mechanism, which is concerned with synchronising changes to individual tiddlers back to a server (see https://tiddlywiki.com/dev/#SyncAdaptorModules for more details).
The following steps are involved:
- The saver mechanism uses the filter defined in $:/config/SaverFilter to specify which modified tiddlers trigger the dirty state for the wiki. (The dirty state is reflected in the red colouring of the "save changes" button in the sidebar).
- The ButtonWidget is used to generate a tm-save-wiki message to trigger the save operation
- The optional parameter for the message specifies the template that will be used for generating the HTML file, defaulting to $:/core/save/all
- The plugin $:/plugins/tiddlywiki/tiddlyweb in the client-server configuration replaces the default template with $:/plugins/tiddlywiki/tiddlyweb/save/offline
- The template includes a variable assignment that specifies a filter to select the tiddlers that should be included in the saved file. It then transcludes the main page template
$:/core/templates/tiddlywiki5.html- The template includes a reference to
$(publishFilter)$that allows the filter to be customised via a global variable
- The template includes a reference to
- The tm-save-wiki handler renders the template to generate the HTML file
- The message handler chooses the highest priority "saver" module that can handle saving the file
- See https://tiddlywiki.com/dev/#Saver for more details
Vous pourriez vous demander si l'architecture de TiddlyWiki en tant que SinglePageApplication serait adaptée pour de gros volume de d'information. En réalité, les utilisateurs de TiddlyWiki travaillent souvent avec des fichiers de 20 or 30 mégaoctets sans problème - et des expérience traitant des gigaoctets ont aussi été couronnées de succès.
Script Files
The TiddlyWiki5 repository contains several scripts in the bin folder that you can use to automate common tasks, or as a useful starting point for your own scripts. See Scripts for building tiddlywiki.com for details of the scripts used to build and release https://tiddlywiki.com/.
All the scripts expect to be run from the root folder of the repository.
serve: serves tw5.com
./bin/serve.sh -h
./bin/serve.sh [edition dir] [username] [password] [host] [port]Or:
./bin/serve.cmd -h
./bin/serve.cmd [edition dir] [username] [password] [host] [port]This script starts TiddlyWiki5 running as an HTTP server, defaulting to the content from the tw5.com-server edition. By default, the Node.js serves on port 8080. If the optional username parameter is provided, it is used for signing edits. If the password is provided then HTTP basic authentication is used. Run the script with the -h parameter to see online help.
To experiment with this configuration, run the script and then visit http://127.0.0.1:8080 in a browser.
Changes made in the browser propagate to the server over HTTP (use the browser developer console to see these requests). The server then syncs changes to the file system (and logs each change to the screen).
test: build and run tests
This script runs the test edition of TiddlyWiki on the server to perform the server-side tests and to build test.html for running the tests in the browser.
lazy: serves tw5.com with lazily loaded images
./bin/lazy.sh <username> [<password>]Or:
./bin/lazy.cmd <username> [<password>]This script serves the tw5.com-server edition content with LazyLoading applied to images.
Introduction
The scrollable widget wraps its content in a scrollable frame. The user can scroll the contents with the mouse or with touch gestures. Code can use the WidgetMessage: tm-scroll to programmatically scroll specific DOM nodes into view.
Content and Attributes
The content of the <$scrollable> widget is displayed within a pair of wrapper DIVs. If the inner DIV is larger then it scrolls within the outer one. CSS is used to specify the size of the outer wrapper.
| Attribute | Description |
|---|---|
| class | The CSS class(es) to be applied to the outer DIV |
| fallthrough | See below |
If a scrollable widget can't handle the tm-scroll message because the inner DIV fits within the outer DIV, then by default the message falls through to the parent widget. Setting the fallthrough attribute to no prevents this behaviour.
Examples
This example requires the following CSS definitions from $:/_tw5.com-styles:
.tc-scrollable-demo {
border: 1px solid <<colour message-border>>;
background-color: <<colour message-background>>;
padding: 1em;
height: 400px;
position: relative;
}This wiki text shows how to display a list within the scrollable widget:
<$scrollable class='tc-scrollable-demo'>
<$list filter='[!is[system]]'>
<$view field='title'/>: <$list filter='[all[current]links[]sort[title]]' storyview='pop'>
<$link><$view field='title'/></$link>
</$list>
</$list>
</$scrollable>
Affichera ceci :
AllTiddlers:
License: $:/core/copyright.txt ShadowTiddlers TiddlyWiki
TableOfContents:
About:
Acknowledgements: Community
Contributors:
Developers: TiddlyWiki
History of TiddlyWiki: JeremyRuston
Philosophy of Tiddlers: Structuring TiddlyWiki Tiddlers TiddlyWiki
BuildCommand: TiddlyWikiFolders
ClearPasswordCommand:
Commands: Using TiddlyWiki on Node.js
EditionsCommand:
FetchCommand:
HelpCommand:
ImportCommand:
InitCommand: Environment Variables on Node.js
ListenCommand: TiddlyWiki WebServer
LoadCommand:
MakeLibraryCommand: UpgradeMechanism
NamedCommandParameters: Commands TiddlyWiki
OutputCommand:
PasswordCommand:
RenderCommand:
RenderTiddlerCommand:
RenderTiddlersCommand:
SaveCommand:
SaveTiddlerCommand:
SaveTiddlersCommand:
ServerCommand: ListenCommand TiddlyWiki WebServer
SetFieldCommand:
UnpackPluginCommand:
VerboseCommand:
VersionCommand:
Community:
Contributing: GitHub HelpingTiddlyWiki Improving TiddlyWiki Documentation OpenSource PullRequest ReportingBugs TiddlyWiki TiddlyWiki5 UnaMesa
Contributor License Agreement: OpenSource TiddlyWiki TiddlyWiki5 UnaMesa
Forums: TiddlyDesktop TiddlyFox TiddlyWiki TiddlyWiki Hangouts TiddlyWikiDev
HelpingTiddlyWiki: Contributing GitHub OpenSource TiddlyWiki
Improving TiddlyWiki Documentation: Documentation Style Guide Informations pour les traducteurs
Latest:
Meetups: OXTWIG TiddlyWiki
OXTWIG: TiddlyWiki
ReportingBugs: Forums GitHub TiddlyWiki
Resources: Community Forums GitHub
Signing the Contributor License Agreement: GitHub
TiddlyWiki Camp Paris: TiddlyWiki
TiddlyWiki Hangouts: TiddlyWiki YouTube
TiddlyWiki European Meetup 2016:
TiddlyWiki European Meetup 2017: TiddlyWiki
Translate TiddlyWiki into your language: GitHub TiddlyWiki
Tutorials:
"A free, open source wiki revisited" by Mark Gibbs, NetworkWorld: TiddlyWiki
"Notizen mit TiddlyWiki systemübergreifend nutzen" by Michael Sonntag: TiddlyWiki
"Setting Up a Personal TiddlyWiki Server on OS X" by Kris Johnson: TiddlyWiki TiddlyWiki on Node.js
"TiddlyWiki 5 im Betatest" by besim: JavaScript TiddlyWiki TiddlyWiki5 TiddlyWikiClassic
"TiddlyWiki" by Sander de Boer: JavaScript NoScript TiddlyWiki
"A Thesis Notebook" by Alberto Molina: TiddlyWiki
Interactive Git Documentation by Devin Weaver:
Obadiah TOC:
PESpot Lesson Planner by Patrick Detzner: TiddlyWiki
"PETTIL - Forth for the Commodore PET" by Charlie Hitselberger: TiddlyWiki
Simple Zork-like Game by Jed Carty: TiddlyWiki
TriTarget.org by Devin Weaver: TiddlyWiki TriTarget
Ace Editor Plugin by Joerg Plewe: IndexedDb SyncAdaptor TiddlyWiki
"BJTools" by buggyj:
"BrainTest - tools for a digital brain" by Danielo Rodriguez:
Code styles and auto format settings for IDEs: TiddlyWiki
"CouchDB Adaptor" by William Shallum: CouchDB TiddlyWiki
"Encrypt single tiddler plugin" by Danielo Rodriguez:
Eucaly's Tiddly World: FieldFilter FlexWidth MatchFilter MonkeyTaggerMacro PopupTagger QuickJump TagBar TagTable TiddlyWiki TitleMe
"Filter Examples" by Tobias Beer: Filters ListWidget
Full Text Search Plugin by Rob Hoelz: TiddlyWiki
"GSD5" by Roma Hicks: TiddlyWiki TiddlyWiki5
"Gospel Bubbles" by Rev. David Gifford:
"Heeg.ru" by sini-Kit: TiddlyWiki
"Hosting TiddlyWiki5 on GoogleDrive" by Tony Ching: TiddlyWiki TiddlyWiki5
"How Does Twederation Work" by Jed Carty: TiddlyWiki
IndexedDB Plugin by Andreas Abeck: IndexedDB IndexedDb SyncAdaptor
Leaflet maps plugin by Sylvain Comte: Filters GeoTiddler TiddlyWiki
MathJax Plugin by Martin Kantor: MathJax MathML TeX TiddlyWiki
Plugins by TheDiveO: FontAwesome TheDiveO TiddlyWiki
Plugins by Uwe Stuehler: TiddlyWiki
SeeAlso by Matias Goldman:
"TB5 - a pocket full of tips" by Tobias Beer: TiddlyWiki
"TW5 Magick" by Stephan Hradek: TiddlyWiki
TW5-SingleExecutable by Jed Carty: TiddlyWiki5
TWCommunitySearch: TiddlyWiki
TWaddle by Matias Goldman: Bigger community ⇄ Better TW TiddlyWiki
TiddlyChrome by Arlen Beiler: TiddlyWiki
TiddlyClip by buggyjay: BuggyJay Firefox TiddlyClip TiddlyWiki
TiddlyDrive Add-on for Google Drive by Joshua Stubbs: TiddlyWiki
TiddlyMap Plugin by Felix Küppers: GitHub TiddlyWiki
TiddlyServer by Arlen Beiler: NodeJS TiddlyServer TiddlyWiki TiddlyWikis
TiddlyWiki Jingle by Måns Mårtensson: TiddlyWiki
"TiddlyWiki Notes" by James Anderson: TiddlyWiki
"TiddlyWiki Posts" by Jeffrey Kishner: TiddlyWiki
TiddlyWiki Video Tutorials by Francis Meetze: TiddlyWiki
TiddlyWiki extensions for Sublime Text 3 by roma0104: TiddlyWiki5
TiddlyWiki extensions for ViM: TiddlyWiki5
"TiddlyWiki for Scholars" by Alberto Molina: TiddlyWiki
"TiddlyWiki guide FR" by Sylvain Naudin: TiddlyWiki
"TiddlyWiki 舞" by Bram Chen: TiddlyWiki
"TiddlyWiki5 Coding" by Chris Hunt: TiddlyWiki TiddlyWiki5
"TiddlyWiki5 Playground" by Ton Gerner: TiddlyWiki
"TiddlyWiki5^2 documenting while learning TiddlyWiki5" by Iannis Zannos: TiddlyWiki TiddlyWiki on Node.js TiddlyWiki5
Tinka by Andreas Hahn: GitHub
Widdly by Opennota: TiddlyWiki
"Wikilabs" by PMario:
"Wills Q&D gTD" by Matabele: TiddlyWiki
"ATWiki" by Lamusia Project: TiddlyWiki
"Cardo - Task and Project Management Wiki" by David Szego:
"Dropboard" by Reid Gould: TiddlyWiki
"Dynamic Tables" by Jed Carty:
"Ghostwriter theme by Rory Gibson" adapted for TW5 by Riz:
"Hacks" by Thomas Elmiger:
"In My Socks" by Jed Carty:
"JD Mobile Layout plugin" by JD: TiddlyWiki
"Lucky Sushi" online shop by sini-Kit:
"Mal's Sandbox" by Mal: $:/core/modules/commands/load.js $:/plugins/malgam/loadnew/loadnew.js JavaScript
"MathCell" by Stephen Kimmel: TiddlyWiki
"Moments: A little color won't hurt" by Riz:
"Noteself" by Danielo Rodríguez:
"SK Plugins" by Stephen Kimmel: TiddlyWiki
"Slides and Stories" by Jan:
"TW5-TeXZilla" plugin by Joe Renes: KaTeX Plugin LaTeX MathJax MathML TiddlyWiki5
"TWeb.at" by Mario Pietsch: TiddlyWeb TiddlyWiki
"Tekan: Kanban that stays with you" by Riz: TiddlyWiki
"TiddlyServer" by Matt Lauber: TiddlyFolder TiddlyServer TiddlyWiki
"TiddlyWiki Knowledge Network" by Dmitry Sokolov:
"TiddlyWiki Toolmap" by David Gifford: TiddlyWiki TiddlyWikis
"TiddlyWiki5 Bourbon" by mkt_memory: TiddlyWiki TiddlyWiki5
"TiddlyWiki5 Forum on Reddit" by Riz: TiddlyWiki5
"Timimi" Extension and executable by Riz:
"X3DOM for TiddlyWiki 5" by Jamal Wills: JavaScript TiddlyWiki
"file-backups" Extension for Firefox by pmario: Saving with the HTML5 fallback saver
"muritest" by Simon Huber: Plugins by Uwe Stuehler
"savetiddlers" Extension for Chrome and Firefox by buggyj: Saving with the HTML5 fallback saver TiddlyFox TiddlyWiki
datepicker plugin based on Pikaday, by kixam: EditTextWidget TiddlyWiki
rboue's plugins for TiddlyWiki: TiddlyWiki
twproxy by Steve Gattuso: TiddlyWiki
vis.js Timeline by emkay, revived by kixam: TiddlyWiki
"Creating a baby journal with TiddlyWiki 5" from A Penguin in Redmond: TiddlyWiki
"Install and run TiddlyWiki on a CentOS 6 VPS using Nginx" from RoseHosting: TiddlyWiki
"Microblogging con Tiddlywiki" by Juan: TiddlyWiki
"デザイン刷新。次の25年を目指すTiddlyWiki" by Moongift: TiddlyWiki
"Shining Ark Using TiddlyWiki" by Helu: TiddlyWiki
"TW5 Tribal Knowledge" from Scott Kingery: TiddlyWiki
"Un wiki sur votre BiblioBox avec TiddlyWiki" from A Penguin in Redmond: BiblioBox TiddlyWiki
ColourPalettes: $:/palette CSS DataTiddlers
Concepts: TiddlyWiki
Current Tiddler: storyTiddler Variable TemplateTiddlers
DataTiddlers: DictionaryTiddlers JSONTiddlers TextReference
Date Fields: DateFormat TiddlerFields TiddlyWiki
DefaultTiddlers: $:/ControlPanel $:/DefaultTiddlers Filter Expression PermaLinks Story River
DictionaryTiddlers: $:/palettes/Vanilla ColourPalettes ContentType DataTiddlers
Dominant Append: Filters Title Selection
ExternalImages: $:/core/templates/canonical-uri-external-image TiddlyWikiFolders
Filters: $:/AdvancedSearch CountWidget Filter Operators Filter Syntax Introduction to filter notation ListWidget TiddlyWiki Title Selection
Hard and Soft Links: Macros Transclusion Variables WikiText
InfoPanel: ShadowTiddlers TiddlerFields Using links to navigate between tiddlers
JSONTiddlers: $:/HistoryList ContentType DataTiddlers JavaScript Object Notation
Keyboard Shortcut Tiddler: $:/ControlPanel Keyboard Shortcut Descriptor KeyboardShortcuts
Macros: JavaScript Macros Macros in WikiText
Messages:
ModuleType: Modules
Modules: JavaScript ModuleType TiddlyWiki5
Order of Tagged Tiddlers: Title List
PermaLinks: $:/ControlPanel Filters TiddliWiki TiddlyWiki
Railroad Diagrams: Railroad Plugin
Selection Constructors: Filter Operators Filter Run Filters Title Selection
ShadowTiddlers: Plugins
Story River: Tiddlers
SystemTags: Creating a custom export format Using Stylesheets
SystemTiddlers: Tiddlers TiddlyWiki
TagTiddlers: InfoPanel
TemplateTiddlers: Current Tiddler TiddlyWiki Transclusion Transclusion with Templates ViewTemplate WikiText
TextReference: DataTiddlers Filter Parameter Filtres IndirectAttributes LinkCatcherWidget RevealWidget TextReference TiddlerFields
TiddlerFields: $:/ControlPanel BagField ColorField CreatedField CreatorField DescriptionField DraftOfField DraftTitleField FooterField LibraryField ListField ModifiedField ModifierField NameField PluginPriorityField PluginTypeField RevisionField SourceField SubtitleField TagsField TextField Tiddlers TiddlyWebAdaptor TitleField TypeField
TiddlerLinks: $:/core/copyright.txt $:/SiteTitle ATiddlerThatDoesntExist Filters InfoPanel StoryView TiddlerLinks TiddlyWiki TiddlyWiki5
Tiddlers: TiddlerFields
TiddlyWiki: Community JeremyRuston ListField Macros OpenSource Philosophy of Tiddlers Raves Structuring TiddlyWiki Tagging TiddlerLinks Tiddlers WikiText
TiddlyWiki5: JavaScript Node.js TiddlyWiki TiddlyWiki5
TiddlyWikiFolders: $:/config/OriginalTiddlerPaths BuildCommand PluginMechanism TiddlerFiles TiddlyWiki on Node.js
Title List: Filters ListField PermaLinks Title Selection
Title Selection: Filters Title List
Transclusion: Philosophy of Tiddlers TemplateTiddlers TextReference TranscludeWidget Transclusion Basic Usage Transclusion in WikiText Transclusion with Templates
Wiki: WikiStore
WikiText: Formatting text in TiddlyWiki Markdown TiddlyWiki
Configuring startup tiddlers: DefaultTiddlers Filter Expression Preserving open tiddlers at startup
Customise TiddlyWiki:
Customising search results: $:/config/SearchResults/Default $:/core/ui/DefaultSearchResultList $:/tags/SearchResults
Page and tiddler layout customisation: $:/config/ViewToolbarButtons/Visibility/Recette $:/core/images/ $:/core/ui/. $:/core/ui/SideBar/More $:/tags/EditTemplate $:/tags/ViewToolbar SystemTag SystemTags TiddlyWiki ViewToolbar
BT: JeremyRuston Osmosoft
Base64:
CamelCase: CamelCase ExempleDeCamelCaseQuiGénèreUnLienVersUnNouveauTiddlerPortantCeNom
Cascading Style Sheets:
Comma-Separated Values:
ContentType: ContentType TiddlyWiki
Data URI: Cascading Style Sheets
Definitions: Concepts TiddlyWiki
Document Object Model: TiddlyWiki on Node.js Widgets
Federatial: JeremyRuston TiddlyWiki
GitHub:
GuerillaWiki: GuerillaWiki TiddlyWiki
HyperText Markup Language: WikiText
JavaScript Object Notation: DataTiddlers
JavaScript:
JeremyRuston: TiddlyWiki
Jermolene: JeremyRuston
Keyboard Shortcut Descriptor: KeyboardWidget
NW.js: Node.js OpenSource this introductory blog post|http://net.tutsplus.com/tutorials/javascript-ajax/introduction-to-html5-desktop-apps-with-node-webkit/ TiddlyWiki on NW.js
Node.js: JavaScript TiddlyWiki on Node.js
OpenSource:
Osmosoft: BT JeremyRuston TiddlyWiki
Percent Encoding: URI
Quine: TiddlyWiki
SingleFileApplication: SinglePageApplication TiddlyWiki
SinglePageApplication: SingleFileApplication SinglePageApplication TiddlyWiki
Stanford JavaScript Crypto Library:
TiddlyDesktop: GitHub Introducing TiddlyDesktop Video node-webkit OpenSource TiddlyDesktop TiddlyDesktop Releases TiddlyWiki TiddlyWikiClassic
TiddlyFox: Firefox GitHub Saving with TiddlyFox Saving with TiddlyFox on Android
TiddlyIE: Saving with TiddlyIE TiddlyIE TiddlyWiki
TiddlySpace: BT Osmosoft TiddlySpace TiddlyWeb TiddlyWiki
TiddlyWeb: BT Osmosoft Tiddlers TiddlyWeb TiddlyWiki TiddlyWiki5
TiddlyWikiClassic: TiddlyWiki
URI:
node-webkit: NW.js
Alice in Wonderland:
Apple:
Caruso - Ave Maria:
GroupedLists: $:/core/ui/MoreSideBar/Types $:/core/ui/SideBar/Recent
ImageGallery Example: $:/tags/Image ListWidget TranscludeWidget
SampleAlert: $:/tags/Alert SampleAlert
SampleNotification:
SampleTabFour:
SampleTabOne:
SampleTabThree:
SampleTabTwo:
SampleTiddlerFirst: SampleTiddlerFirst
SampleTiddlerSecond: SampleTiddlerSecond
SampleTiddlerThird: SampleTiddlerThird
SampleWizard: SampleWizard
SampleWizard2: SampleWizard2
TabbedExampleType:
Contents: TableOfContentsMacro
First:
FirstOne:
FirstThree:
FirstTwo:
Fourth:
Second:
SecondOne:
SecondThree:
SecondThreeOne:
SecondThreeThree:
SecondThreeTwo:
SecondTwo:
Third:
ThirdOne:
ThirdThree:
ThirdTwo:
Example Table of Contents: Expandable:
Example Table of Contents: Selectively Expandable:
Example Table of Contents: Simple:
Example Table of Contents: Sorted Expandable:
Example Table of Contents: Tabbed Internal:
Example Table of Contents: Tabbed External:
Example for tag Macro:
Compose ballad: TaskManagementExample
Get the Ring: TaskManagementExample
Go to Mordor: TaskManagementExample
Kill the Dragon: TaskManagementExample
Make the beds: TaskManagementExample
TaskManagementExample: TiddlyWiki5
TaskManagementExample (Draggable): TaskManagementDemo
TaskManagementExampleDraggableTemplate:
done:
task: TaskManagementExample
TiddlyWiki.mp3:
Days of the Week:
Friday:
Monday:
Saturday:
Sunday:
Thursday:
Tuesday:
Wednesday:
sampletag1:
sampletag2:
Blog Edition: TiddlyWiki
Editions: TiddlyWiki
Empty Edition:
Full Edition:
Résumé Builder Edition: TiddlyWiki
Text-Slicer Edition: TiddlyWiki
XLSX Utilities Edition: TiddlyWiki
AutoSave: $:/config/AutoSave $:/ControlPanel
DateFormat: ViewWidget
Drag and Drop: $:/ControlPanel DragAndDropMechanism Importing Tiddlers list-links-draggable Macro list-tagged-draggable Macro ListField Mobile Drag And Drop Shim Plugin
Features: Quine TiddlyWiki
Future Proof: OpenSource
Importing Tiddlers: Drag and Drop How to export tiddlers TiddlyWiki
LazyLoading: commande serveur LazyLoadingMechanism TiddlyWeb TiddlyWiki TiddlyWiki in the Sky for TiddlyWeb TiddlyWiki on Node.js
Modals: TiddlyWiki WidgetMessage: tm-modal
Notifications: TiddlyWiki
SafeMode:
Scalability: SinglePageApplication TiddlyWiki
Searching in TiddlyWiki: $:/AdvancedSearch Filters
StartupActions: ActionWidgets Pragma TiddlyWiki
ListField: $:/StoryList Filters NavigatorWidget Tagging TiddlerFields Title List
MultiTiddlerFileSyntax: MultiTiddlerFiles
MultiTiddlerFiles: $:/language/ControlPanel/Basics/Caption $:/language/ControlPanel/Basics/Version MultiTiddlerFiles
TiddlerFiles: ContentType
Filter Operators: Filter Parameter Filter Step Filter Syntax Filters Selection Constructors Title Selection
Introduction to filter notation: TextReference Variables
addprefix Operator:
addsuffix Operator:
after Operator:
all Operator: Current Tiddler Dominant Append Filter Parameter Hard and Soft Links ShadowTiddlers
allafter Operator:
allbefore Operator:
append Operator:
backlinks Operator: Dominant Append
before Operator:
bf Operator:
butfirst Operator:
butlast Operator:
commands Operator:
contains Operator:
count Operator:
days Operator:
decodehtml Operator:
decodeuri Operator:
decodeuricomponent Operator:
each Operator: Title List
eachday Operator:
editiondescription Operator:
editions Operator:
encodehtml Operator:
encodeuri Operator:
encodeuricomponent Operator:
enlist Operator:
escaperegexp Operator:
addprefix Operator (Examples):
addsuffix Operator (Examples):
after Operator (Examples): Thursday
all Operator (Examples):
allafter Operator (Examples):
allbefore Operator (Examples):
append Operator (Examples):
backlinks Operator (Examples):
before Operator (Examples): Thursday
butlast Operator (Examples):
commands Operator (Examples):
contains Operator (Examples):
count Operator (Examples):
days Operator (Examples):
decodehtml Operator (Examples):
decodeuri Operator (Examples):
decodeuricomponent Operator (Examples):
each Operator (Examples): GroupedLists
eachday Operator (Examples): GroupedLists
encodehtml Operator (Examples):
encodeuri Operator (Examples):
encodeuricomponent Operator (Examples):
enlist Operator (Examples):
escaperegexp Operator (Examples):
field Operator (Examples):
fields Operator (Examples):
first Operator (Examples):
get Operator (Examples):
getindex Operator (Examples):
has Operator (Examples):
indexes Operator (Examples):
is Operator (Examples):
jsonstringify Operator (Examples):
last Operator (Examples):
limit Operator (Examples):
links Operator (Examples): Filter Operators HelloThere links Operator
list Operator (Examples):
listed Operator (Examples):
lookup Operator (Examples):
minlength Operator (Examples):
modules Operator (Examples):
moduletypes Operator (Examples):
move Operator (Examples):
next Operator (Examples):
nsort Operator (Examples):
nsortcs Operator (Examples):
nth Operator (Examples):
plugintiddlers Operator (Examples):
prefix Operator (Examples):
prepend Operator (Examples):
previous Operator (Examples):
putafter Operator (Examples):
putbefore Operator (Examples):
putfirst Operator (Examples):
putlast Operator (Examples):
regexp Operator (Examples): Variables
remove Operator (Examples):
removeprefix Operator (Examples):
removesuffix Operator (Examples):
replace Operator (Examples):
rest Operator (Examples):
reverse Operator (Examples):
sameday Operator (Examples):
search Operator (Examples):
shadowsource Operator (Examples):
sort Operator (Examples):
sortan Operator (Examples): Apple
sortby Operator (Examples):
sortcs Operator (Examples):
splitbefore Operator (Examples):
storyviews Operator (Examples):
stringify Operator (Examples):
subfilter Operator (Examples):
subtiddlerfields Operator (Examples):
suffix Operator (Examples):
tag Operator (Examples):
tagging Operator (Examples):
tags Operator (Examples):
title Operator (Examples):
untagged Operator (Examples):
field Operator: Filter Operators Filter Step
fields Operator: Dominant Append
first Operator:
get Operator: Filter Operators Title Selection
getindex Operator: DataTiddlers Dominant Append
has Operator:
haschanged Operator:
indexes Operator: DataTiddlers Dominant Append JSONTiddlers
insertbefore Operator:
is Operator: ContentType Current Tiddler Filter Expression Filter Run Hard and Soft Links ShadowTiddlers SystemTiddlers
jsonstringify Operator: stringify Operator
last Operator:
limit Operator:
links Operator: Dominant Append
list Operator: Current Tiddler TextReference
listed Operator: Dominant Append Title List
lookup Operator:
minlength Operator:
modules Operator:
moduletypes Operator:
move Operator:
next Operator:
nsort Operator:
nsortcs Operator:
nth Operator:
order Operator:
plugintiddlers Operator:
prefix Operator:
prepend Operator:
previous Operator:
putafter Operator:
putbefore Operator:
putfirst Operator:
putlast Operator:
range Operator: Formula Plugin
regexp Operator: Filter Run Variables
remove Operator:
removeprefix Operator:
removesuffix Operator:
replace Operator:
rest Operator:
reverse Operator:
sameday Operator:
search Operator:
shadowsource Operator: Dominant Append
sort Operator:
sortan Operator:
sortby Operator:
sortcs Operator:
splitbefore Operator: Dominant Append Table-of-Contents Macros
storyviews Operator: Modules
stringify Operator: jsonstringify Operator
subfilter Operator:
subtiddlerfields Operator:
suffix Operator:
Filter Expression: Dominant Append Filter Run Filter Syntax ShadowTiddlers
Filter Parameter: DataTiddlers Filter Operators TextReference TiddlerFields Variables
Filter Run: Filter Expression Filter Step Title Selection
Filter Step: Filter Expression Filter Operators Filter Run Filter Syntax TiddlerFields Title Selection
Filter Syntax: Filter Expression Filter Run Filter Step Title Selection
Filter Whitespace: Filter Expression Filter Run
tag Operator: Order of Tagged Tiddlers
tagging Operator: Dominant Append Order of Tagged Tiddlers
tags Operator: Dominant Append
title Operator: Selection Constructors
untagged Operator:
GettingStarted - Android: TiddlyFox
GettingStarted - Chrome:
GettingStarted - Firefox: TiddlyFox
GettingStarted - Internet Explorer: Windows HTA Hack
GettingStarted - Node.js:
GettingStarted - Online: CouchDB TiddlyWiki
GettingStarted - Safari:
GettingStarted - iOS:
GettingStarted: Encryption Saving on TiddlySpot TiddlyDesktop
A Gentle Guide to TiddlyWiki: GettingStarted TableOfContents TiddlyWiki on Node.js
Discover TiddlyWiki: Community Philosophy of Tiddlers TableOfContents
HelloThere: "TiddlyWiki for Scholars" by Alberto Molina Creating and editing tiddlers Philosophy of Tiddlers Sharing your tiddlers with others Structuring TiddlyWiki TaskManagementExample TiddlyWiki
HelloThumbnail:
Some of the things you can do with TiddlyWiki: ImageGallery Example Motovun Jack.jpg SampleWizard TaskManagementExample
Ten reasons to switch to TiddlyWiki:
What happened to the original TiddlyWiki?: TiddlyWiki TiddlyWiki5 TiddlyWikiClassic WikiText
HelloThumbnail - Classic:
HelloThumbnail - Developers:
HelloThumbnail - Gentle Guide:
HelloThumbnail - HelpingTiddlyWiki:
HelloThumbnail - Introduction Video:
HelloThumbnail - Latest Version:
HelloThumbnail - TWEUM2017:
HelloThumbnail - TiddlyMap:
Hidden Setting: New-Image Type: $:/config/NewImageType
Hidden Setting: Filename for Save Wiki Button: $:/config/SaveWikiButton/Filename $:/ControlPanel $:/SiteTitle
Hidden Setting: Template for Save Wiki Button: $:/config/SaveWikiButton/Template
Hidden Setting: Search Minimum Length: $:/config/Search/MinLength
Hidden Setting: Tags Minimum Length: $:/config/Tags/MinLength
Hidden Setting: Scroll Top Adjustment: TiddlyWiki
Hidden Setting: Search AutoFocus: $:/config/Search/AutoFocus TiddlyWiki
Hidden Setting: Typing Refresh Delay: $:/config/Drafts/TypingTimeout TiddlyWiki
Hidden Settings: $:/ControlPanel TiddlyWiki
Adding a Twitter Follow button: TiddlyWiki
Adding a table of contents to the sidebar: Macros Table-of-Contents Macros TableOfContents Tagging
Adopt a Titles Policy: CamelCase demo DeveloperDocs How to build a TiddlyWiki5 from individual tiddlers task TiddlerFields TiddlyWiki TiddlyWiki on Node.js TiddlyWiki5
Concatenating text and variables using macro substitution: MacroCallWidget
Configuring the default TiddlerInfo tab: $:/config/TiddlerInfo/Default
Creating SubStories: HelloThere
Creating a custom export format: $:/tags/Exporter
Creating a splash screen: $:/SplashScreen $:/tags/RawMarkupWikified/TopBody SystemTag: $:/tags/RawMarkupWikified/TopBody TiddlyWiki WikiText
Custom styles by data-tiddler-title: Custom data-styles
Custom styles by user-class: $:/core/ui/ViewTemplate $:/TagManager How to apply custom styles
Attribute Selectors:
Custom Styles FAQ:
Custom data-styles: DejaVu
Custom styles by data-tags: Custom data-styles Hard Linebreaks with CSS
Editing Tiddlers with Emacs: TiddlyWiki
Editing Tiddlers with Vim: TiddlyWiki
Editor toolbar: Markdown Plugin WikiText
Formatting List Results as Tables with CSS - Specified Columns Methods: Formatting List Results as Tables (no CSS) Formatting List Results as Tables with CSS - Variable Column Method
Formatting List Results as Tables with CSS - Variable Column Method: Formatting List Results as Tables (no CSS) Formatting List Results as Tables with CSS - Specified Columns Methods
Formatting List Results as Tables (no CSS): Formatting List Results as Tables with CSS - Specified Columns Methods Formatting List Results as Tables with CSS - Variable Column Method nth Operator
Generating Static Sites with TiddlyWiki: DefaultTiddlers JavaScript RenderTiddlerCommand RenderTiddlersCommand TiddlyWiki TiddlyWiki5
Hard Linebreaks with CSS: Custom data-styles Hard Linebreaks with CSS - Example How to apply custom styles TiddlyWiki
Hard Linebreaks with CSS - Example: WikiText
Height of text editor:
How to add a banner for GitHub contributions: $:/ContributionBanner GitHub Improving TiddlyWiki Documentation TiddlyWiki TiddlyWikiFolders
How to apply custom styles by tag: NightReader Using Stylesheets
How to apply custom styles:
How to build a TiddlyWiki5 from individual tiddlers: InitCommand Installing TiddlyWiki on Node.js TiddlerFiles TiddlyWiki5 TiddlyWikiFolders
How to change the sort order of sub-branches in a TOC macro: Table-of-Contents Macros
How to create keyboard shortcuts: $:/config/shortcuts- $:/config/shortcuts-linux/ $:/config/shortcuts-mac/ $:/config/shortcuts-not-linux/ $:/config/shortcuts-not-mac/ $:/config/shortcuts-not-windows/ $:/config/shortcuts-windows/ $:/config/shortcuts/ $:/ControlPanel $:/core/ui/ControlPanel/KeyboardShortcuts $:/core/ui/PageMacros $:/tags/Macro ActionNavigateWidget Key Descriptor Keyboard Shortcut Descriptor KeyboardWidget my-macro-tiddler
How to Customize TiddlyDesktop: HelloThere TiddlyDesktop TiddlyWiki
How to embed PDF and other documents: ContentType ExternalImages node.js
How to export tiddlers: $:/AdvancedSearch Filters
How to hide the author's and other fields with CSS:
How to put the last modification date in a banner: $:/_MyRibbon $:/plugins/tiddlywiki/github-fork-ribbon $:/tags/PageControls $:/tags/PageTemplate TiddlyWiki
How to widen tiddlers (aka storyriver):
How to add a new tab to the sidebar: $:/core/ui/SideBar/Open $:/tags/SideBar SystemTags TableOfContents TableOfContentsMacro Tagging
How to turn off camel case linking: $:/ControlPanel CamelCase
Insert link: Insert picture WikiText
Insert picture: WikiText
KeyboardShortcuts:
Making a custom journal button: $:/core/ui/Buttons/new-journal
Making curved text with SVG:
More actions:
Preserving open tiddlers at startup: $:/DefaultTiddlers $:/StoryList TiddlyWiki
Setting a favicon: $:/favicon.ico ServerCommand TiddlyWiki
Setting a page background image: $:/ControlPanel DarkPhotos ExternalImages Images in WikiText
Sharing a TiddlyWiki on Dropbox: TiddlyWiki
Simple ways to write protect tiddlers:
Structuring TiddlyWiki: DataTiddlers ListWidget Tagging TiddlerLinks Tiddlers TiddlyWiki5
Tagging: $:/TagManager Creating and editing tiddlers Filters ListField Page and tiddler layout customisation
Text preview:
The First Rule of Using TiddlyWiki: TiddlyFox TiddlyWiki
Upgrading: $:/AdvancedSearch SafeMode The First Rule of Using TiddlyWiki TiddlyWiki on Node.js Upgrading TiddlyWiki on Node.js
Using Excise: EditorToolbar Linking in WikiText Macros Transclusion
Using SVG: $:/SVGExampleRadius HelloThere Motovun Jack.svg Tiddler Fishes.svg TiddlyWiki5 Typed Blocks in WikiText WikiText
Using Stamp:
Using Stylesheets: ColourPalettes RevealWidget Stylesheet Macros TiddlyWiki WikiTexte
Using TiddlyWiki for GitHub project documentation: GitHub LinkWidget MarkDown ReadMe TiddlyWiki5 TiddlyWikiFolders
Using a custom path prefix with the client-server edition: ServerCommand TiddlyWiki on Node.js
Windows HTA Hack: TiddlyWiki
Q: Is there a way to create dynamic stylesheets?: Q: How can I use a custom field to style a tiddler?
Q: How can I use a custom field to style a tiddler?: Attribute Selectors
Q: What if a tiddler has no tags?: Attribute Selectors
Q: How can I style a tiddler if it has "this" AND "that" tag?: Attribute Selectors
Q: How can I style a tiddler if it has "this" OR "that" tag?: Attribute Selectors
Blurry Lawn.jpg:
Dev Thumbnail.jpg:
Introduction Video Thumbnail.jpg:
Motovun Jack.ascii:
Motovun Jack.jpg:
Motovun Jack.pdf:
Motovun Jack.svg:
New Release Banner:
Newnham Horizon.jpg:
PerlinLight.jpg:
Pinstripe.gif:
TWEUM Thumbnail.jpg:
Tiddler Fishes.svg:
Tiddler Poster.png:
TiddlyFox Apocalypse.png:
TiddlyMap.png:
TiddlyWiki Classic.png:
Language Icon: ca-ES:
Language Icon: cs-CZ:
Language Icon: da-DK:
Language Icon: de-AT:
Language Icon: de-DE:
Language Icon: el-GR:
Language Icon: en-US:
Language Icon: es-ES:
Language Icon: fr-FR:
Language Icon: hi-IN:
Language Icon: ia-IA:
Language Icon: it-IT:
Language Icon: ja-JP:
Language Icon: ko-KR:
Language Icon: nl-NL:
Language Icon: pa-IN:
Language Icon: pt-PT:
Language Icon: ru-RU:
Language Icon: sk-SK:
Language Icon: sv-SE:
Language Icon: zh-Hans:
Language Icon: zh-Hant:
Edición en Castellano:
Chinese (Simplified) Edition: Chinese (Traditional) Edition TiddlyWiki
Chinese (Traditional) Edition: Chinese (Simplified) Edition TiddlyWiki
Édition en Français (France): TiddlyWiki
Deutsch (Österreich) Edition: Deutsch (Deutschland) Edition TiddlyWiki
Deutsch (Deutschland) Edition: Deutsch (Österreich) Edition TiddlyWiki
Korean (Korea Republic) Edition:
LanguageGallery Example: ListWidget Tagging TranscludeWidget
Languages: TiddlyWiki Translate TiddlyWiki into your language
Copying tiddlers between TiddlyWiki files: TiddlyWiki
Introduction to Lists: Filter Operators Filters HelloThere list Operator list-links Macro listed Operator ListField Lists in WikiText ListWidget Order of Tagged Tiddlers The Extended Listops Filters TiddlerFields TiddlyWiki Transclusion with Templates WikiText
Learning:
changecount Macro: Current Tiddler Macros
colour Macro: $:/palettes/Vanilla Cascading Style Sheets ColourPalettes Macros
contrastcolour Macro: $:/core/ui/TagTemplate Cascading Style Sheets Macros
Core Macros: Macros
csvtiddlers Macro: $:/core/templates/exporters/CsvFile Comma-Separated Values Filters Macros Title Selection
datauri Macro: Base64 Cascading Style Sheets Data URI Macros
dumpvariables Macro: Macros Variables Widgets
jsontiddlers Macro: $:/core/templates/exporters/JsonFile Filters JavaScript Object Notation Macros Title Selection
lingo Macro: Macros
list-links Macro: Cascading Style Sheets Filters Macros Title Selection
makedatauri Macro: ContentType Data URI Macros
now Macro: DateFormat Macros
qualify Macro: Macros StateMechanism Widgets
resolvepath Macro: Macros
Stylesheet Macros: $:/core/macros/CSS Cascading Style Sheets Macros
Table-of-Contents Macros: Filter Expression Filter Step How to add a new tab to the sidebar Order of Tagged Tiddlers SecondThree StateMechanism SystemTiddlers Table-of-Contents Macros (Examples) Tagging TemplateTiddlers
tabs Macro: Cascading Style Sheets Filters Macros StateMechanism SystemTiddlers TemplateTiddlers Title Selection
tag Macro: Current Tiddler Macros
timeline Macro: Date Fields DateFormat Filter Expression Filter Step Macros
version Macro: Macros
colour-picker Macro: Macros
copy-to-clipboard Macro: Macros
Macro Calls in WikiText (Examples):
changecount Macro (Examples): New Tiddler
colour-picker Macro (Example 1):
colour-picker Macro (Examples):
colour Macro (Examples):
copy-to-clipboard Macro (Examples):
datauri Macro (Examples): WikiText
dumpvariables Macro (Examples):
image-picker Macro (Example 1):
image-picker Macro (Example 2):
image-picker Macro (Examples):
lingo Macro (Examples): DateFormat
list-links-draggable Macro (Examples):
list-links Macro (Examples):
list-tagged-draggable Macro (Examples):
makedatauri Macro (Examples):
now Macro (Examples):
qualify Macro (Examples): $:/editions/tw5.com/macro-examples/qualify-transcluded
resolvepath Macro (Examples):
tabs Macro (Examples):
tag Macro (Examples):
thumbnail Macro (Examples):
timeline Macro (Examples):
Table-of-Contents Macros (Examples): TableOfContents
tree Macro (Examples):
version Macro (Examples):
image-picker Macro: Filter Expression Filter Step Macros
jsontiddler Macro: JavaScript Object Notation Macros
list-links-draggable Macro: currentTiddler Variable Drag and Drop ListField Macros
list-tagged-draggable Macro: currentTiddler Variable Drag and Drop Macros Order of Tagged Tiddlers
Macro Call Syntax: Filter Whitespace Macros
Macro Definition Syntax: Filter Whitespace Macros PlaceHolder
Macro Syntax:
tag-picker Macro: Macros
tag-pill Macro: Macros tag Macro
thumbnail Macro: Macros
tree Macro: Macros
AlertMechanism: $:/tags/Alert TiddlyWiki
DraftMechanism: ListWidget NavigatorWidget
DragAndDropMechanism: ButtonWidget Drag and Drop DraggableWidget DroppableWidget DropzoneWidget LinkWidget
HistoryMechanism: $:/config/EmptyStoryMessage $:/HistoryList GettingStarted
InfoMechanism: $:/info/browser $:/info/browser/screen/height $:/info/browser/screen/width $:/info/node $:/info/url/full $:/info/url/host $:/info/url/hostname $:/info/url/origin $:/info/url/pathname $:/info/url/port $:/info/url/protocol $:/info/url/search Node.js WikiText
Mechanisms: TiddlyWiki
PluginMechanism: Installing a plugin from the plugin library JavaScript Modules PluginFolders Plugins ShadowTiddlers ThemeMechanism TiddlyWiki TiddlyWiki on Node.js TiddlyWiki5
PopupMechanism: ButtonWidget RevealWidget StateMechanism
SavingMechanism: $:/config/SaverFilter $:/core/save/all $:/plugins/tiddlywiki/tiddlyweb $:/plugins/tiddlywiki/tiddlyweb/save/offline ButtonWidget SavingMechanism TiddlyWiki WidgetMessage: tm-save-wiki
StateMechanism: $:/core/ui/PageTemplate $:/InfoPanelState $:/StoryList DraftMechanism NavigationMechanism StateMechanism StateTiddler TiddlyWiki WikiText
TranslationMechanism: $:/language $:/language/Docs/ModuleTypes/isfilteroperator $:/language/EditTemplate/Fields/Add/Value/Placeholder $:/language/EditTemplate/Shadow/OverriddenWarning TiddlyWiki
UpgradeMechanism:
SampleModal:
WidgetMessage: tm-add-field: ButtonWidget FieldManglerWidget
WidgetMessage: tm-add-tag: ButtonWidget FieldManglerWidget
WidgetMessage: tm-auto-save-wiki: SaverModules SyncMechanism TiddlyWiki WidgetMessage: tm-delete-tiddler WidgetMessage: tm-perform-import WidgetMessage: tm-save-tiddler
WidgetMessage: tm-browser-refresh: ButtonWidget
WidgetMessage: tm-cancel-tiddler: ButtonWidget NavigatorWidget
WidgetMessage: tm-clear-password: $:/isEncrypted ButtonWidget EncryptionMechanism
WidgetMessage: tm-close-all-tiddlers: ButtonWidget NavigatorWidget
WidgetMessage: tm-close-other-tiddlers: ButtonWidget NavigatorWidget
WidgetMessage: tm-close-tiddler: ButtonWidget NavigatorWidget
WidgetMessage: tm-copy-to-clipboard: $:/language/Notifications/CopiedToClipboard/Failed $:/language/Notifications/CopiedToClipboard/Succeeded ButtonWidget TiddlyWiki
WidgetMessage: tm-delete-tiddler: ButtonWidget NavigatorWidget
WidgetMessage: tm-download-file: ButtonWidget SaverModules SyncMechanism TiddlyWiki
WidgetMessage: tm-edit-bitmap-operation: $:/core/ui/EditorToolbar/size-dropdown ActionWidget ButtonWidget
WidgetMessage: tm-edit-text-operation: $:/core/ui/EditorToolbar/bold ActionWidget ButtonWidget
WidgetMessage: tm-edit-tiddler: ActionSendMessageWidget ButtonWidget NavigatorWidget
WidgetMessage: tm-fold-all-tiddlers: ButtonWidget NavigatorWidget
WidgetMessage: tm-fold-other-tiddlers: ButtonWidget NavigatorWidget
WidgetMessage: tm-fold-tiddler: ButtonWidget NavigatorWidget
WidgetMessage: tm-full-screen: TiddlyWiki
WidgetMessage: tm-home: $:/DefaultTiddlers ButtonWidget PermaLinks
WidgetMessage: tm-import-tiddlers: $:/Import BrowseWidget DropzoneWidget NavigatorWidget UpgradeMechanism
WidgetMessage: tm-load-plugin-from-library: ButtonWidget CodeMirror
WidgetMessage: tm-load-plugin-library: ButtonWidget
WidgetMessage: tm-login: $:/status/IsLoggedIn $:/status/UserName SyncAdaptorModules SyncMechanism TiddlyWiki
WidgetMessage: tm-logout: $:/status/IsLoggedIn $:/status/UserName SyncAdaptorModules SyncMechanism TiddlyWiki
WidgetMessage: tm-modal: ButtonWidget TiddlyWiki
WidgetMessage: tm-navigate: ActionNavigateWidget ButtonWidget LinkWidget NavigatorWidget
WidgetMessage: tm-new-tiddler: ActionSendMessageWidget ButtonWidget NavigatorWidget TaskTemplate
WidgetMessage: tm-notify: TiddlyWiki
WidgetMessage: tm-open-external-window: ActionSendMessageWidget ButtonWidget
WidgetMessage: tm-open-window: ButtonWidget
WidgetMessage: tm-perform-import: $:/Import ButtonWidget NavigatorWidget UpgradeMechanism
WidgetMessage: tm-permalink: ButtonWidget PermaLinks
WidgetMessage: tm-permaview: ButtonWidget PermaLinks
WidgetMessage: tm-print: ButtonWidget
WidgetMessage: tm-remove-field: ButtonWidget FieldManglerWidget
WidgetMessage: tm-remove-tag: ButtonWidget FieldManglerWidget
WidgetMessage: tm-save-tiddler: ButtonWidget NavigatorWidget
WidgetMessage: tm-save-wiki: ButtonWidget SaverModules SyncMechanism TiddlyWiki
WidgetMessage: tm-scroll: ScrollableWidget
WidgetMessage: tm-server-refresh: SyncAdaptorModules SyncMechanism TiddlyWiki
WidgetMessage: tm-set-password: $:/isEncrypted ButtonWidget EncryptionMechanism
WidgetMessage: tm-unfold-all-tiddlers: ButtonWidget NavigatorWidget
Building TiddlyWikiClassic: FieldsWidget JavaScript TiddlyWiki TiddlyWiki on Node.js TiddlyWiki5 TiddlyWikiClassic ViewWidget
Customising Tiddler File Naming: $:/config/FileSystemPaths Filter Syntax task TiddlyWiki on Node.js TiddlyWikiFolders
Environment Variables on Node.js: GitHub InitCommand TiddlyWiki on Node.js TiddlyWiki5
Installing TiddlyWiki Prerelease on Node.js: GitHub npm TiddlyWiki5
Installing TiddlyWiki on Node.js: Node.js
Naming of System Tiddlers: JavaScript TiddlyWiki
Scripts for TiddlyWiki on Node.js: LazyLoading Scripts for building tiddlywiki.com TiddlyWiki TiddlyWiki5
Serving TW5 from Android: Installing TiddlyWiki on Node.js TiddlyWiki on Node.js Using TiddlyWiki on Node.js
TiddlyWiki on Node.js: Installing TiddlyWiki on Node.js Node.js Upgrading TiddlyWiki on Node.js Using TiddlyWiki on Node.js
TiddlyWiki5 Versioning: TiddlyWiki TiddlyWiki5
Upgrading TiddlyWiki on Node.js: TiddlyWiki on Node.js
Using TiddlyWiki on Node.js: TiddlerFiles TiddlyWiki5 TiddlyWikiFiles TiddlyWikiFolders
Working with the TiddlyWiki5 repository: Contributing GitHub Installing TiddlyWiki on Node.js npm Scripts for TiddlyWiki on Node.js TiddlyWiki TiddlyWiki5 Working with the TiddlyWiki5 repository video
tiddlywiki.files Files: LazyLoading Release 5.1.14 TiddlerFiles TiddlyWikiFolders
tiddlywiki.info Files: $:/config/OriginalTiddlerPaths BuildCommand TiddlyWikiFolders
Beaker Browser: Saving on Beaker Browser TiddlyWiki
Platforms: TiddlyWiki
TiddlyFox Apocalypse: Beaker Browser GettingStarted TiddlyDesktop TiddlyFox TiddlyWiki
TiddlyWiki in the Sky for TiddlyWeb: LazyLoading TiddlySpace TiddlyWeb TiddlyWiki
Amazon Web Services Plugin: JavaScript TiddlyWiki
CodeMirror Plugin: TiddlyWiki
D3 Plugin: TiddlyWiki
Disabling Plugins:
Dynaview Plugin:
External Attachments Plugin: TiddlyDesktop TiddlyWiki
Highlight Plugin:
Innerwiki Plugin: TiddlyWiki
Installing a plugin from the plugin library: $:/ControlPanel The First Rule of Using TiddlyWiki TiddlyWiki
KaTeX Plugin:
Manually installing a plugin: $:/plugins/tiddlywiki/example The First Rule of Using TiddlyWiki TiddlyWiki
Markdown Plugin: Markdown
Mobile Drag And Drop Shim Plugin:
OfficialPlugins: Installing a plugin from the plugin library TiddlyWiki UpgradeMechanism Working with the TiddlyWiki5 repository
Plugin Editions: TiddlyWiki
PluginFolders:
Plugin Fields:
Plugin Information Tiddlers: $:/ControlPanel $:/core/en-GB/readme $:/core/icon $:/core/readme TiddlyWiki TranscludeWidget
Plugins: $:/ControlPanel $:/plugins/tiddlywiki/exemple JavaScript PluginMechanism ShadowTiddlers The First Rule of Using TiddlyWiki TiddlyWiki TiddlyWiki5
Railroad Plugin:
SaveTrail Plugin: TiddlyWiki
TW2Parser Plugin: TiddlyWiki WIkiText
Twitter Plugin:
Uninstalling a plugin: $:/ControlPanel The First Rule of Using TiddlyWiki TiddlyWiki
ContributingTemplate: TiddlyWiki5
ReadMe: JavaScript WikiText
ReadMeBinFolder:
TiddlyWiki2ReadMe: TiddlyWikiClassic
Reference: TiddlyWiki
BetaReleases: TiddlyWiki5 TiddlyWiki5 Versioning
Release 5.1.0: TiddlyWiki
Release 5.1.1: ButtonWidget KaTeX Plugin Release 5.0.17-beta TiddlyWiki
Release 5.1.10: $:/AdvancedSearch $:/ControlPanel ActionListopsWidget ActionSetFieldWidget ActionWidgets Alice in Wonderland Blog Edition days Operator EditTextWidget FieldManglerWidget GitHub Hidden Setting: Keyboard Shortcuts Highlight Plugin How to apply custom styles by tag JavaScript KaTeX KeyboardWidget LazyLoading RenderTiddlerCommand Résumé Builder Edition SaveTiddlersCommand SelectWidget ServerCommand tabs Macro Text-Slicer Edition TiddlerLinks TiddlyWiki TiddlyWikiFolders WikiText
Release 5.1.11: Release 5.1.10
Release 5.1.12: $:/AdvancedSearch ActionWidgets CodeMirror colour-picker Macro Customising Tiddler File Naming days Operator EditShortcutWidget EntityWidget has Operator image-picker Macro KaTeX LinkCatcherWidget ScrollableWidget SelectWidget Table-of-Contents Macros TiddlyWiki Upgrading ViewWidget WebDav WikifyWidget WikiText
Release 5.1.13: KaTeX Plugin TiddlyWiki
Release 5.1.14: $:/AdvancedSearch $:/ControlPanel $:/core/images/print-button $:/Manager all Operator Block Quotes in WikiText CheckboxWidget decodehtml Operator decodeuri Operator decodeuricomponent Operator Drag and Drop encodehtml Operator encodeuri Operator encodeuricomponent Operator enlist Operator escaperegexp Operator FetchCommand has Operator HighlightPlugin InfoMechanism is Operator JavaScript KaTeX Plugin KeyboardWidget minlength Operator move Operator order Operator RenderTiddlerCommand SaveTrail Plugin SetWidget stringify Operator Table-of-Contents Macros tag Operator TiddlyFox TiddlyWiki TiddlyWiki on Beaker Browser tiddlywiki.files Files TiddlyWikiFolders Twitter Plugin WikifyWidget wikiparserrules Operator XLSX Utilities Edition
Release 5.1.15: $:/themes/tiddlywiki/vanilla/themetweaks Amazon Web Services Plugin Beaker Browser BrowseWidget DateFormat DropzoneWidget External Attachments Plugin ExternalImages FetchCommand ImportCommand JavaScript jsonstringify Operator LinkCatcherWidget lookup Operator Pragma RenderCommand RenderTiddlerCommand RenderTiddlersCommand SaveCommand SaveTiddlerCommand SaveTiddlersCommand SetWidget TiddlyDesktop TiddlyWiki tree Macro ViewWidget
Release 5.1.16: CheckboxWidget copy-to-clipboard Macro Custom data-styles DiffTextWidget DraggableWidget DroppableWidget Dynaview Plugin each Operator InfoMechanism is Operator KaTeX Plugin LinkWidget list-links Macro list-tagged-draggable Macro Macro Definitions in WikiText RadioWidget RangeWidget RevealWidget SelectWidget ServerCommand SetWidget sortan Operator StartupActions subtiddlerfields Operator tabs Macro TaskManagementExample (Draggable) Text-Slicer Edition The Extended Listops Filters TiddlyWiki ViewTemplate WidgetMessage: tm-copy-to-clipboard
Release 5.1.17: $:/status/UserName is Operator TiddlyWiki
Release 5.1.18: $:/ControlPanel $:/plugins/tiddlywiki/comments $:/SiteTitle $:/TagManager $tw.platform.isLinux ButtonWidget contains Operator Creating a splash screen decodeuri Operator decodeuricomponent Operator Filter Expression Hidden Setting: Scroll Top Adjustment How to create keyboard shortcuts ImportVariablesWidget JavaScript KaTeX KaTeX Plugin LinkWidget list-tagged-draggable Macro ListenCommand NamedCommandParameters Pragma range Operator RevealWidget search Operator ServerCommand subfilter Operator Table-of-Contents Macros tag Macro TiddlyWiki tree Macro tv-adjust-heading-level Variable tv-show-missing-links Variable Using HTTPS Using the external JavaScript template Using the integrated static file server Using the read-only single tiddler view WebServer WebServer Authorization WebServer Parameter: authenticated-user-header WebServer Parameter: credentials WebServer Parameter: csrf-disable WebServer Parameter: debug-level WidgetMessage: tm-edit-text-operation WidgetMessage: tm-full-screen WidgetMessage: tm-new-tiddler
Release 5.1.19: ButtonWidget Hidden Setting: Filename for Save Wiki Button KaTeX Plugin Release 5.1.18 TiddlyWiki WebServer
Release 5.1.2: KaTeX Plugin TiddlySpot
Release 5.1.3: ActionWidgets Audio Creating and editing tiddlers Creating journal tiddlers ImageWidget LaTeX TiddlyWiki
Release 5.1.4: Release 5.1.3 TiddlyWiki ViewWidget
Release 5.1.5: $:/AdvancedSearch $:/ControlPanel $:/core/images/video $:/TagManager ActionDeleteFieldWidget ActionDeleteTiddlerWidget ActionSetFieldWidget CodeMirror Customising search results EditionsCommand EditTextWidget Example Table of Contents: Tabbed Internal ImageGallery Example RevealWidget Table-of-Contents Macros TiddlyWiki TiddlyWikiFolders UnpackPluginCommand WidgetMessage: tm-download-file WidgetMessage: tm-modal WidgetMessage: tm-new-tiddler WidgetMessage: tm-save-wiki
Release 5.1.6: BrowseWidget InitCommand Table-of-Contents Macros TiddlyWiki
Release 5.1.7: GettingStarted Release 5.1.6
Release 5.1.8: $:/AdvancedSearch $:/ControlPanel $:/plugins/tiddlywiki/help $:/TagManager CheckboxWidget eachday Operator editiondescription Operator editions Operator Filter Syntax Highlight Plugin ImageGallery Example KaTeX Plugin Railroad Plugin RenderTiddlersCommand resolvepath Macro RevealWidget sameday Operator Setting a page background image TiddlyWiki
Release 5.1.9: $:/ControlPanel ActionSendMessageWidget ButtonWidget CodeMirror Hidden Setting: Search AutoFocus Hidden Setting: Typing Refresh Delay Hidden Settings Releases TiddlyDesktop TiddlyWiki tv-tiddler-preview Variable VarsWidget
ReleaseTemplate:
Releases:
TiddlyWiki Releases: AlphaReleases BetaReleases TiddlyWiki5 TiddlyWiki5 Versioning
AlphaReleases: TiddlyWiki5 TiddlyWiki5 Versioning
Release 5.0.0-alpha.11: BrowseWidget DropzoneWidget EditBitmapWidget EditTextWidget EditWidget ListWidget NavigatorWidget SetVariableWidget TiddlyWiki5 TranscludeWidget ViewWidget
Release 5.0.0-alpha.12: TiddlyWeb TiddlyWiki5
Release 5.0.0-alpha.13: $:/tags/ControlPanel $:/tags/MoreSideBar $:/tags/SideBar $:/tags/TiddlerInfo CodeMirror DaveGifford ViewWidget
Release 5.0.0-alpha.14: $:/ControlPanel CheckboxWidget PasswordWidget
Release 5.0.0-alpha.15: $:/tags/EditTemplate $:/tags/EditToolbar $:/tags/PageControls $:/tags/ViewToolbar TiddlyWeb TranscludeWidget
Release 5.0.0-alpha.16: $:/LeftSideBar $:/TopSideBar Node.js SavingMechanism ServerCommand TiddlySpot TiddlyWiki5 TiddlyWikiFolders WikiText
Release 5.0.0-alpha.17:
Release 5.0.1-alpha: Block Quotes in WikiText GitHub StephanHradek TiddlyWiki5 Versioning Upgrading
Changes to filters in 5.0.9-beta: FilterOperator: all FilterOperator: field FilterOperator: is FilterOperator: title
Notes for upgrading to 5.0.11-beta: OutputCommand TiddlyWikiFolder
Notes for upgrading to 5.0.8-beta: $:/SiteSubtitle $:/SiteTitle InitCommand SiteSubtitle SiteTitle TiddlyWiki TiddlyWiki on Node.js
Release 5.0.10-beta: DateFormat Images in WikiText ImageWidget SafeMode TiddlyWeb
Release 5.0.11-beta: $:/AdvancedSearch $:/core/ui/PageMacros $:/core/wiki/title BuildCommand ClearPasswordCommand CodeBlockWidget CodeMirror JavaScript Linking in WikiText Notes for upgrading to 5.0.11-beta OutputCommand PermaLinks StartupMechanism The First Rule of Using TiddlyWiki TiddlerFiles TiddlyWiki TiddlyWikiFolders WikiLinks WikiText
Release 5.0.12-beta:
Release 5.0.13-beta: $:/ControlPanel $:/tags/RawMarkup CodeMirror Environment Variables on Node.js ExternalImages HTML in WikiText ImportVariablesWidget LinkWidget Macros in WikiText PermaLinks SaveTiddlersCommand SelectWidget ServerCommand SetFieldCommand TableOfContents TextWidget TiddlyWiki Widgets in WikiText
Release 5.0.14-beta: $:/ControlPanel $:/core/modules/upgraders/plugins.js $:/core/modules/upgraders/system.js $:/core/modules/upgraders/themetweaks.js $:/HistoryList $:/StoryList $:/TagManager BuildCommand CamelCase CheckboxWidget Filter Parameter ImportMechanism InfoMechanism ReleaseHistory SystemTags TiddlerWidget TiddlyWiki TranscludeWidget UpgradeLibrary UpgradePlugin UpgraderModules WidgetMessage: tw-permalink WidgetMessage: tw-permaview
Release 5.0.15-beta: $:/ControlPanel $:/TagManager DropzoneWidget ImageWidget PluginMechanism Startup Modules.svg Table-of-Contents Macros TiddlyWiki WidgetMessage: tw-browser-refresh WidgetMessage: tw-home
Release 5.0.16-beta: Configuring the default TiddlerInfo tab Table-of-Contents Macros TiddlyWiki TiddlyWikiClassic WidgetMessage: tw-browser-refresh
Release 5.0.17-beta: $:/ControlPanel BrowseWidget ButtonWidget ImageWidget LinkWidget RegExp SafeMode Table-of-Contents Macros TiddlyWiki
Release 5.0.18-beta: RadioWidget TiddlyWiki
Release 5.0.2-beta: DavidJade GitHub Hard Linebreaks in WikiText InternetExplorer JavaScript Macros PluginMechanism RadioWidget Saving on InternetExplorer Saving with TiddlyIE StephanHradek TiddlyFox TiddlyWeb
Release 5.0.3-beta:
Release 5.0.4-beta: DavidJade GitHub InternetExplorer RadioWidget SaveTiddlerCommand StephanHradek TiddlyWiki on Node.js TiddlyWikiFolders Using favicons
Release 5.0.5-beta: Setting a favicon
Release 5.0.6-beta: $:/AdvancedSearch DavidJade Formatting in WikiText InternetExplorer ServerCommand StephanHradek Tables in WikiText TiddlerFilters TiddlyWiki on node-webkit
Release 5.0.7-beta: $:/AdvancedSearch $:/ControlPanel $:/DefaultTiddlers $:/plugins/tiddlywiki/nodewebkitsaver GitHub Naming of System Tiddlers node-webkit Saving on a PHP Server ServerCommand TemplateTiddlers TextReference TextWidget TiddlerFilters TiddlyDesktop TiddlyFox TiddlyWiki TiddlyWiki Coding Style Guidelines TiddlyWiki on Firefox for Android Video ViewWidget
Release 5.0.8-beta: $:/AdvancedSearch $:/ControlPanel $:/SiteSubtitle $:/SiteTitle $:/TagManager AlertMechanism AutoSave BramChen ButtonWidget ColourPalettes EditBitmapWidget HelpCommand How to create plugins in the browser InitCommand KeyboardWidget LazyLoading MultiTiddlerFiles Notes for upgrading to 5.0.8-beta RevealWidget SiteSubtitle SiteTitle TiddlerFilter Formal Grammar TiddlerFilters TiddlyWeb TiddlyWiki on Node.js TranscludeWidget TranslationMechanism ViewWidget WidgetMessages
Release 5.0.9-beta: $:/AdvancedSearch $:/ControlPanel $:/TagManager ButtonWidget CecilyView Changes to filters in 5.0.9-beta Community Developing plugins using Node.js and GitHub LinkWidget Making curved text with SVG ScrollableWidget TiddlerFilters TiddlerTags TiddlyWeb TiddlyWiki TiddlyWiki Architecture TiddlyWikiClassic Transclusion in WikiText WidgetMessage: tw-home
RoadMap: GitHub TiddlyWikiClassic
Emergency Tiddler Export: TiddlyWiki
Encryption: TiddlyWiki5
Example config-tiddlyweb-host for IIS:
Example package.json for IIS:
Example tiddlywiki.info for IIS:
Example web.config for IIS:
Installing TiddlyWiki on Microsoft Internet Information Server: Node.js TiddlyWiki
Saving on Android: TiddlyWiki TiddlyWiki5
Saving on Beaker Browser: Beaker Browser TiddlyWiki
Saving on TiddlyDesktop: Introducing TiddlyDesktop Video TiddlyDesktop TiddlyWiki
Saving on TiddlySpot: $:/ControlPanel Saving with TiddlyFox TiddlySpot TiddlyWiki TiddlyWikiClassic Upgrading
Saving on a PHP Server: TiddlySpot TiddlyWiki
Saving on iPad/iPhone: TiddlyWiki TiddlyWiki5
Saving via WebDAV: "Wikilabs" by PMario HowTo TiddlyWiki Upgrading WebDAV
Saving via a Minimal Ruby Server:
Saving with TiddlyFox on Android: Download Firefox for Android TiddlyFox TiddlyWiki on Firefox for Android Video
Saving with TiddlyFox: Download Firefox Firefox for Android Saving with TiddlyFox on Android TiddlyFox
Saving with TiddlyIE: Download TiddlyIE
Saving with the HTML5 fallback saver: Download TiddlyWiki
Saving: TiddlyWiki
TiddlyWiki Cloud: TiddlyWiki
Documentation Macros: WikiText
Documentation Style Guide: Adopt a Titles Policy
Instruction Tiddlers: Reference Tiddlers
Reference Tiddlers:
Spelling:
Technical Prose Style: Instruction Tiddlers
Tiddler Structure: Philosophy of Tiddlers Reference Tiddlers
Tiddler Title Policy: CamelCase Instruction Tiddlers Reference Tiddlers
Typography: Documentation Macros WikiText
Deprecated - What does it mean: Custom styles by tag
SystemTag: $:/tags/AboveStory: SystemTags
SystemTag: $:/tags/AdvancedSearch: SystemTags
SystemTag: $:/tags/AdvancedSearch/FilterButton: SystemTags
SystemTag: $:/tags/Alert: SystemTags
SystemTag: $:/tags/BelowStory: SystemTags
SystemTag: $:/tags/ControlPanel: SystemTags
SystemTag: $:/tags/ControlPanel/Advanced: SystemTags
SystemTag: $:/tags/ControlPanel/Appearance: SystemTags
SystemTag: $:/tags/ControlPanel/Info: SystemTags
SystemTag: $:/tags/ControlPanel/Saving: SystemTags
SystemTag: $:/tags/ControlPanel/Settings: SystemTags
SystemTag: $:/tags/ControlPanel/Toolbars: SystemTags
SystemTag: $:/tags/EditPreview: SystemTags
SystemTag: $:/tags/EditTemplate: SystemTags
SystemTag: $:/tags/EditToolbar: SystemTags
SystemTag: $:/tags/EditorToolbar: SystemTags
SystemTag: $:/tags/Exporter: SystemTags
SystemTag: $:/tags/Filter: SystemTags
SystemTag: $:/tags/Image: SystemTags
SystemTag: $:/tags/ImportPreview: SystemTags
SystemTag: $:/tags/KeyboardShortcut: Keyboard Shortcut Descriptor Keyboard Shortcut Tiddler SystemTags
SystemTag: $:/tags/Macro: SystemTags
SystemTag: $:/tags/Manager/ItemMain: $:/Manager SystemTags
SystemTag: $:/tags/Manager/ItemSidebar: SystemTags
SystemTag: $:/tags/MoreSideBar: SystemTags
SystemTag: $:/tags/MoreSideBar/Plugins: SystemTags
SystemTag: $:/tags/PageControls: SystemTags
SystemTag: $:/tags/PageTemplate: SystemTags
SystemTag: $:/tags/Palette: SystemTags
SystemTag: $:/tags/PluginLibrary: SystemTags
SystemTag: $:/tags/RawMarkup: SystemTags
SystemTag: $:/tags/RawMarkupWikified: ImportVariablesWidget SystemTags
SystemTag: $:/tags/RawMarkupWikified/BottomBody: ImportVariablesWidget SystemTags
SystemTag: $:/tags/RawMarkupWikified/TopBody: ImportVariablesWidget SystemTags
SystemTag: $:/tags/RawMarkupWikified/TopHead: ImportVariablesWidget SystemTags
SystemTag: $:/tags/RawStaticContent: SystemTags
SystemTag: $:/tags/RemoteAssetInfo: SystemTags
SystemTag: $:/tags/SearchResults: SystemTags
SystemTag: $:/tags/ServerConnection: SystemTags
SystemTag: $:/tags/SideBar: SystemTags
SystemTag: $:/tags/SideBarSegment: SystemTags
SystemTag: $:/tags/StartupAction: SystemTags
SystemTag: $:/tags/StartupAction/Browser: SystemTags
SystemTag: $:/tags/StartupAction/Node: SystemTags
SystemTag: $:/tags/Stylesheet: SystemTags
SystemTag: $:/tags/TagDropdown: SystemTags
SystemTag: $:/tags/Texteditor/Snippet: SystemTags
SystemTag: $:/tags/TiddlerInfo: SystemTags
SystemTag: $:/tags/TiddlerInfoSegment: SystemTags
SystemTag: $:/tags/TiddlerInfo/Advanced: SystemTags
SystemTag: $:/tags/ToolbarButtonStyle: SystemTags
SystemTag: $:/tags/TopLeftBar: SystemTags
SystemTag: $:/tags/TopRightBar: SystemTags
SystemTag: $:/tags/ViewTemplate: SystemTags
SystemTag: $:/tags/ViewToolbar: SystemTags
TiddlyDesktop Releases:
Core Variables: Variables
Variables: Core Variables Variables in WikiText Widgets WikiText
currentTiddler Variable: Current Tiddler TemplateTiddlers Variables WikiText
storyTiddler Variable: $:/core/ui/EditTemplate $:/core/ui/PageTemplate/story $:/core/ui/ViewTemplate Variables Widgets
transclusion Variable: Current Tiddler Transclusion Variables Widgets
actionTiddler Variable: DroppableWidget Title List Variables
Sample Headings 1,2,3:
Sample Headings 3,4,5:
Sample Headings 4,5,6:
currentTiddler Variable (Examples):
storyTiddler Variable (Examples):
transclusion Variable (Examples):
tv-adjust-heading-level Variable (Examples):
tv-config-toolbar-class Variable (Examples): Cascading Style Sheets
tv-config-toolbar-icons Variable (Examples):
tv-config-toolbar-text Variable (Examples):
tv-get-export-image-link Variable (Examples):
tv-wikilink-tooltip Variable (Examples): HelloThere
tv-wikilinks Variable (Examples):
modifier Variable: DroppableWidget Variables
namespace Variable: Document Object Model HyperText Markup Language Variables
tv-adjust-heading-level Variable: Headings in WikiText Variables
tv-auto-open-on-import Variable: $:/Import Variables
tv-config-toolbar-class Variable: Cascading Style Sheets Variables
tv-config-toolbar-icons Variable: Variables
tv-config-toolbar-text Variable: Variables
tv-filter-export-link Variable: tv-wikilink-template Variable Variables
tv-get-export-image-link Variable: Images in WikiText Macros TiddlyWiki on Node.js Variables
tv-get-export-link Variable: Macros Variables
tv-get-export-path Variable: Percent Encoding TiddlyWiki on Node.js Variables
tv-history-list Variable: NavigatorWidget Variables
tv-show-missing-links Variable: $:/ControlPanel Variables
tv-story-list Variable: NavigatorWidget Variables
tv-tiddler-preview Variable: Variables
tv-wikilink-template Variable: Macros Percent Encoding Variables
tv-wikilink-tooltip Variable: Macros Variables WikiText
tv-wikilinks Variable: Variables
Getting Started Video: TiddlyWiki
Introducing TiddlyDesktop Video: TiddlyDesktop
Introduction Video: TiddlyWiki
TiddlyWiki on Firefox for Android Video: TiddlyWiki
Videos: Contributing TiddlyWiki
Working with the TiddlyWiki5 repository video: Working with the TiddlyWiki5 repository
TiddlyWeb JSON tiddler format: TiddlyWeb
Using HTTPS: TiddlyWiki WebServer WebServer Parameter: tls-cert WebServer Parameter: tls-key
Using the external JavaScript template: JavaScript TiddlyWiki WebServer Parameter: root-tiddler
Using the integrated static file server: ExternalImages
Using the read-only single tiddler view: TiddlyWiki WebServer Parameter: system-tiddler-render-template WebServer Parameter: system-tiddler-render-type WebServer Parameter: tiddler-render-template WebServer Parameter: tiddler-render-type
WebServer API: TiddlyWiki WebServer
WebServer API: Delete Tiddler:
WebServer API: Force Basic Authentication Login:
WebServer API: Get All Tiddlers: TiddlyWeb JSON tiddler format
WebServer API: Get Favicon: $:/favicon.ico
WebServer API: Get File: Using the integrated static file server
WebServer API: Get Rendered Tiddler: Using the read-only single tiddler view
WebServer API: Get Server Status: TiddlyWiki WebServer Parameter: anon-username
WebServer API: Get Tiddler: TiddlyWeb JSON tiddler format
WebServer API: Get Wiki: WebServer Parameter: root-render-type WebServer Parameter: root-serve-type WebServer Parameter: root-tiddler
WebServer API: Put Tiddler: TiddlyWeb JSON tiddler format
WebServer Anonymous Access: WebServer Parameter: readers WebServer Parameter: writers
WebServer Authentication: TiddlyWiki WebServer Anonymous Access WebServer Basic Authentication WebServer Header Authentication
WebServer Authorization: $:/status/IsReadOnly TiddlyWiki WebServer WebServer Authentication WebServer Parameter: credentials WebServer Parameter: readers WebServer Parameter: writers
WebServer Basic Authentication: WebServer Authentication WebServer Authorization WebServer Parameter: credentials WebServer Parameter: password WebServer Parameter: username
WebServer Guides: WebServer
WebServer Header Authentication: WebServer Parameter: authenticated-user-header
WebServer Parameter: anon-username: WebServer Parameters
WebServer Parameter: authenticated-user-header: TiddlyWiki WebServer Header Authentication WebServer Parameters
WebServer Parameter: credentials: WebServer Basic Authentication WebServer Parameter: password WebServer Parameter: username WebServer Parameters
WebServer Parameter: csrf-disable: WebServer Parameters
WebServer Parameter: debug-level: WebServer Parameters
WebServer Parameter: host: WebServer Parameters
WebServer Parameter: password: WebServer Basic Authentication WebServer Parameter: username WebServer Parameters
WebServer Parameter: path-prefix: WebServer Parameters
WebServer Parameter: port: WebServer Parameters
WebServer Parameter: readers: WebServer Authorization WebServer Parameters
WebServer Parameter: root-render-type: WebServer Parameter: root-tiddler WebServer Parameters
WebServer Parameter: root-serve-type: WebServer Parameters
WebServer Parameter: root-tiddler: WebServer Parameters
WebServer Parameter: system-tiddler-render-template: Using the read-only single tiddler view WebServer Parameters
WebServer Parameter: system-tiddler-render-type: Using the read-only single tiddler view WebServer Parameters
WebServer Parameter: tiddler-render-template: Using the read-only single tiddler view WebServer Parameters
WebServer Parameter: tiddler-render-type: Using the read-only single tiddler view WebServer Parameters
WebServer Parameter: tls-cert: Using HTTPS WebServer Parameters
WebServer Parameter: tls-key: Using HTTPS WebServer Parameters
WebServer Parameter: username: WebServer Basic Authentication WebServer Parameter: credentials WebServer Parameter: password WebServer Parameter: readers WebServer Parameter: writers WebServer Parameters
WebServer Parameter: writers: WebServer Authorization WebServer Parameters
WebServer Parameters: WebServer
WebServer: ListenCommand NamedCommandParameters ServerCommand TiddlyWiki TiddlyWiki on Node.js WebServer WebServer Anonymous Access WebServer API WebServer Authentication WebServer Authorization WebServer Basic Authentication WebServer Header Authentication WebServer Parameter: host WebServer Parameter: password WebServer Parameter: readers WebServer Parameter: username WebServer Parameter: writers
ActionCreateTiddlerWidget: ActionWidgets ButtonWidget StoryRiver WidgetMessage: tm-new-tiddler
ActionCreateTiddlerWidget Example:
ActionDeleteFieldWidget: ActionWidgets ButtonWidget Current Tiddler HelloThere
ActionDeleteTiddlerWidget: ActionWidgets ButtonWidget HelloThere TableOfContents WidgetMessage: tm-delete-tiddler
ActionListopsWidget: ActionWidgets ButtonWidget Current Tiddler DataTiddlers The Extended Listops Filters
ActionNavigateWidget: ActionWidgets ButtonWidget Current Tiddler WidgetMessage: tm-navigate
ActionSendMessageWidget: ActionWidgets ButtonWidget Messages WidgetMessage: tm-new-tiddler
ActionSetFieldWidget: ActionWidgets ButtonWidget Current Tiddler DataTiddlers HelloThere
ActionWidgets: ButtonWidget
BrowseWidget: JavaScript NavigatorWidget TiddlyWiki WidgetMessage: tm-import-tiddlers
ButtonWidget: Accessibility ActionWidgets Messages PopupMechanism TextReference
CheckboxWidget: ActionSendMessageWidget ActionSetFieldWidget ActionWidgets Current Tiddler DataTiddlers ExampleData FieldManglerWidget SetWidget
CodeBlockWidget: Highlight Plugin
CountWidget: Filters
DiffTextWidget: $:/language/Diffs/CountMessage
DraggableWidget: actionTiddler Variable DragAndDropMechanism DraggableWidget LinkWidget Mobile Drag And Drop Shim Plugin Title List
DroppableWidget: actionTiddler Variable DragAndDropMechanism DroppableWidget Mobile Drag And Drop Shim Plugin modifier Variable
DropzoneWidget: JavaScript LinkWidget NavigatorWidget WidgetMessage: tm-import-tiddlers
EditBitmapWidget: $:/config/BitmapEditor/Colour $:/config/BitmapEditor/LineWidth Current Tiddler
EditTextWidget: AppSettings ChangeAppSettings CurrentTiddler TemplateTiddlers
EditWidget: Current Tiddler EditBitmapWidget EditTextWidget
EncryptWidget: BootMechanism EncryptionMechanism PasswordVault TiddlyWiki5
EntityWidget:
FieldMangler Widget (Examples):
FieldManglerWidget: Current Tiddler Messages
FieldsWidget: Current Tiddler FileSavingMechanism TiddlyWiki TiddlyWiki5
ImageWidget: ExternalImages
ImportVariablesWidget: $:/core/ui/PageTemplate Filters ImportVariablesWidget Pragma
KeyboardWidget: ActionWidgets Messages
LinkCatcherWidget: ActionWidgets Messages WidgetMessage: tm-navigate
LinkWidget: Current Tiddler DraggableWidget HelloThere LinkCatcherWidget Macros WikiText
ListWidget: DraftMechanism Filters GroupedLists HistoryMechanism ListWidget TiddlyWiki5 Variables
ListopsData:
MacroCallWidget: $:/snippets/allfields $:/snippets/modules $:/themes/tiddlywiki/starlight/styles.tid ContentType
NavigatorWidget: Messages Variables
PasswordWidget: PasswordVault TiddlyWiki5
RadioWidget: AnimalColours Current Tiddler DataTiddlers
RangeWidget: Current Tiddler
RevealWidget: PopupMechanism RevealWidget StateTiddlers
ScrollableWidget: $:/_tw5.com-styles WidgetMessage: tm-scroll
SelectWidget: $:/SiteTitle ActionWidgets DataTiddlers ListWidget TableOfContents
SetVariableWidget: SetWidget
SetWidget: Variables
TextWidget: WikifyWidget WikiText
The Extended Listops Filters: DaysOfTheWeek
TiddlerWidget: $:/core/ui/ViewTemplate $:/tags/Macro Current Tiddler How to apply custom styles by tag TiddlerWidget
TranscludeWidget: $:/DefaultTiddlers DataTiddlers Plugins SubTiddler TiddlyWiki TranscludeWidget
VarsWidget: SetWidget
ViewWidget: $:/DefaultTiddlers Current Tiddler DateFormat JavaScript Plugins SubTiddler
Widgets: HTML in WikiText Widgets in WikiText WikiText
WikifyWidget: ContentType Variables
Block Quotes in WikiText: Listes avec WikiText
Code Blocks in WikiText:
Dashes in WikiText: Tirets
Definitions in WikiText:
Formatting in WikiText: Code Blocks in WikiText WikiText
HTML in WikiText: Codes HTML Formatting in WikiText Macros in WikiText Transclusion in WikiText WikiText
HTML Links in WikiText: MyLinkDestination TiddlyWiki
Hard Linebreaks in WikiText: Paragraphs in WikiText WikiTexte : HTML
Headings in WikiText: Styles and Classes in WikiText
Horizontal Rules in WikiText: Dashes in WikiText
Images in WikiText: ImageWidget WikiText
Linking in WikiText: CamelCase LinkWidget WikiText
Lists in WikiText: les blocs avec WikiText
Macro Calls in WikiText: Macro Call Syntax Macro Calls in WikiText (Examples) Macros Transclusion Variables
Macro Definitions in WikiText: Macro Definition Syntax Macros PlaceHolder Pragma Title Selection Variables
Macros in WikiText: Macro Calls in WikiText Macro Definitions in WikiText Macros WikiText
Paragraphs in WikiText: Hard Linebreaks in WikiText
Styles and Classes in WikiText:
Tables in WikiText: Formatting in WikiText TiddlyWiki5
Transclusion Basic Usage: TextReference TiddlerA TiddlerB TiddlerFields TiddlyWiki Transclusion Transclusion in WikiText Transclusion with Templates
Transclusion and Substitution: HTML in WikiText Introduction to filter notation Macros in WikiText Transclusion in WikiText WikiText
Transclusion in WikiText: currentTiddler Variable DataTiddlers Filters TemplateTiddlers TextReference TiddlerWidget TranscludeWidget Transclusion and Substitution Transclusion Basic Usage Transclusion with Templates WikiText
Transclusion with Templates: Current Tiddler Styles and Classes in WikiText TemplateTiddlers TextReference TranscludeWidget Transclusion Basic Usage Transclusion in WikiText
Typed Blocks in WikiText: ContentType WikiText
Variables in WikiText: Filter Operators Filter Parameter ImportVariablesWidget Macro Calls in WikiText Macro Definitions in WikiText Macros Macros in WikiText Variables Widgets in WikiText
Widgets in WikiText: HTML in WikiText WikiText
Audio: Caruso - Ave Maria Images in WikiText TiddlyWiki TiddlyWiki.mp3
BrowserCompatibility: TiddlyWiki
Creating and editing tiddlers: AutoSave ContentType Creating journal tiddlers italique bleu ListField WikiText
Creating journal tiddlers: $:/ControlPanel DateFormat Title List
Formatting text in TiddlyWiki: CamelCase HelloThere History of TiddlyWiki Linking in WikiText TiddlyWiki WikiText
Navigating between open tiddlers:
Performance: ExternalImages TiddlyWiki
Sharing your tiddlers with others: PermaLinks PermaView Sharing a TiddlyWiki on Dropbox
Using links to navigate between tiddlers: Filters Linking in WikiText ListField ListWidget ShadowTiddlers SystemTiddlers TiddlyWiki Transclusion in WikiText
Working with TiddlyWiki:
Codes HTML:
Configurations: TiddlyWiki
Development of TiddlyWiki5:
Documentation pour les traducteurs:
Exporter un sous-ensemble de tiddlers: $:/AdvancedSearch 5.1.5 Filters
FederatialLimited: JeremyRuston
FilterOperator: fields:
FilterOperators: Filter Parameter Filter Step Filter Syntax Filters Selection Constructors Title Selection
Future:
Glossaire en-GB -> fr-FR: ListField NavigatorWidget
Growth of TiddlyWiki:
ImportTiddlers: $:/ControlPanel GoogleChrome TiddlyWiki5
Informations pour les traducteurs: $:/editions/fr-FR/CSS stylesheets/latex $:/editions/fr-FR/util-macros Exporter un sous-ensemble de tiddlers Glossaire en-GB -> fr-FR Improving TiddlyWiki Documentation Linking in WikiText
Introduction to filters notation: TextReference Variables
Launch of TiddlyWiki:
Leaving BT: BT TiddlyWiki5
Lexique:
Markdown:
NowMacro: DateFormat
Origins of Tiddlywiki: JavaScript
Osmosoft and TiddlySpace: BT Osmosoft TiddlySpace TiddlyWeb
Sainte Anastasie.png:
Saving on InternetExplorer: InternetExplorer Saving with TiddlyIE Windows HTA Hack
Saving on Safari: Download TiddlyWiki
TableOfContentsMacro Expandable Example:
TableOfContentsMacro: How to add a new tab to the sidebar SecondThree Tagging
TabsMacro: $:/state/tab Tagging
TiddlyWikiFiles:
Tirets:
UsingSVG: $:/SVGExampleRadius HelloThere Motovun Jack.svg Tiddler Fishes.svg TiddlyWiki5 Typed Blocks in WikiText WikiText
"Briefcase" by Roma Hicks:
| purpose | filter the input by searching tiddler content |
|---|---|
| input | a selection of titles |
| suffix | the search operator uses a rich suffix, see below for details |
| parameter | one or more search terms, separated by spaces, or a literal search string |
| output | those input tiddlers in which all of the search terms can be found in the value of field F |
! output | those input tiddlers in which not all of the search terms can be found |
New in: 5.1.18 The search filter operator was significantly enhanced in 5.1.18. Earlier versions do not support the extended syntax and therefore do not permit searching multiple fields, or the literal or casesensitive options.
The search operator uses an extended syntax that permits multiple fields and flags to be passed:
[search:<field list>:<flag list>[<operand>]]- field list: a comma delimited list of field names to restrict the search
- defaults to
tags,textandtitleif blank - an asterisk
*instead of the field list causes the search to be performed across all fields available on each tiddler - preceding the list with a minus sign
-reverses the order so that the search is performed on all fields except the listed fields
- defaults to
- flag list: a comma delimited list of flags (defaults to
wordsif blank) - operand: filter operand
This example searches the fields title and caption for a case-sensitive match for the literal string :
[search:title,caption:literal,casesensitive[The first]]The available flags are:
- Search mode - the first to be set of the following flags determines the type of search that is performed:
- literal: considers the search string to be a literal string, and requires an exact match
- whitespace: considers the search string to be a literal string, but will consider all runs of whitespace to be equivalent to a single space. Thus
A BmatchesA B - regexp: treats the search string as a regular expression. Note that the regexp option obviates the need for the older
regexpoperator. - words: (the default) treats the search string as a list of tokens separated by whitespace, and matches if all of the tokens appear in the string (regardless of ordering and whether there is other text in between)
- casesensitive: if present, this flag forces a case-sensitive match, where upper and lower case letters are considered different. By default, upper and lower case letters are considered identical for matching purposes.
[!is[system]search[table]]
[all[shadows]search[table]]
[search:caption[arch]]
arch in their caption field[search:*[arch]]
arch in any field[search:-title,caption[arch]]
arch in any field except title and caption[!is[system]search[the first]]
[!is[system]search::literal[the first]]
[!is[system]search::literal,casesensitive[The first]]
[search:caption,description:casesensitive,words[arch]]
arch in their caption or description fieldsUne recherche rapide et maléable avec TiddlyWiki.
Recherche standard
Saisir du texte dans la case recherche du menu latéral listera une liste de tous les tiddlers contenant ce texte.
- (Notez que les onglets du menu latéral seront masqués par les résultats de la recherche jusqu'à ce que vous cliquiez sur le 'x' à droite de la case de recherche pour les faire disparaitre)
Recherche avancée
Cliquer sur l'icone loupe à droit de la case de recherche ouvrira $:/AdvancedSearch, un tiddler contenant 4 onglets :
- L'onglet standard est un autre présentation de la case recherche du menu classique
- L'onglet système étend la recherche aux tiddlers système
- L'onglet shadows étend la recherche aux tiddlers shadows
- L'onglet filtre n'est pas une case de recherche, en soi, mais juste un moyen d'avoir une liste de tous les tiddlers selon les critères définis par le filtre, par exemple, "Toutes les étiquettes hormis les tags système"
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
A simple technique for adding tag-based cross references to the default view template.
See also: - is a feature to generate a "See also:" section after the tiddler text, somewhat like in Wikipedia articles.
Le résultat du filtre d'une étape dépend de son opérateur:
- La plupart des opérateurs forment leurs résultats à partir de leurs entrées. Par exemple, la plupart produisent un sous-ensemble de leur entrée, et se faisant, méritent vraiment leur nom de "filtres",car ils réduisent la taille du résultat généré par la séquence. Ces opérateurs sont nommés modifieurs de sélection.
- Quelques opérateurs ignorent leurs entrées et génèrent un résultat indépendant. Ils sont appelés constructeurs de sélection : Ils construisent une sélection entièrement nouvelle.
Un bon exemple de constructeur est l'opérateur title. Le résultat de [title[A]title[B]] est juste B. Mais l'ajout de l'opérateur modifieur field, [title[A]field:title[B] ne produit plus rien du tout.
Introduction
The select widget displays a popup menu based on a HTML select element. The popup (or dropdown) contains a list of items defined by <option> and <optgroup> elements.
Every time the user selects a new value in the menu, the selected value is written to the text of a specified tiddler field or index and any ActionWidgets within the actions attribute are triggered. Conversely, if the tiddler value is changed independently the select widget is automatically updated to reflect the new value.
In multiple selection mode, the list of selected values is bound to the specified tiddler field or index. Browsers generally use the ctrl or cmd keys for multiple selection.
For example, this select widget displays a list of the tags in this wiki:
<$select tiddler=<<qualify 'select-demo'>> default='HelloThere'>
<$list filter='[all[shadows+tiddlers]tags[]sort[title]]'>
<option value=<<currentTiddler>>><$view field='title'/></option>
</$list>
</$select>Affichera ceci :
The state tiddler currently contains:
See the text change as you switch entries in the select widget. Try changing the value of the state tiddler and see the select widget change. Notice how the select widget only displays an entry if there is a precise match with the tiddler text.
Content and Attributes
The content of the <$select> widget should be one or more HTML <option> or <optiongroup> elements that provide the available values.
| Attribute | Description |
|---|---|
| tiddler | The title of the tiddler containing the value to be displayed/modified by the select widget (defaults to the current tiddler) |
| field | The field name for the value in the current tiddler (defaults to "text") |
| index | The index of a property in a DataTiddler (takes precedence over the field attribute) |
| class | CSS classes to be assigned to the HTML select element |
| default | Default value to be used if the tiddler, field or index specifies a missing value |
| multiple | If present, switches to multiple selection mode |
| size | The number of rows to display in multiple selection mode |
| actions | A string containing ActionWidgets to be triggered when the key combination is detected |
Examples
Simple Lists
This example sets the title of the current wiki $:/SiteTitle to one of a list of book titles:
<$select tiddler='$:/SiteTitle'>
<option>A Tale of Two Cities</option>
<option>A New Kind of Science</option>
<option>The Dice Man</option>
</$select>Affichera ceci :
Value lists
In this example the value attribute has been used to specify the text that should be used as the value of the entry instead of the display text.
<$select tiddler='$:/SiteTitle'>
<option value='cities'>A Tale of Two Cities</option>
<option value='science'>A New Kind of Science</option>
<option value='dice'>The Dice Man</option>
</$select>Affichera ceci :
Option Groups
Entries in the list can be grouped together with the <optgroup> element
<$select tiddler='$:/SiteTitle'>
<optgroup label='Fiction'>
<option value='cities'>A Tale of Two Cities</option>
<option value='dice'>The Dice Man</option>
</optgroup>
<optgroup label='Non-fiction'>
<option value='science'>A New Kind of Science</option>
<option value='recursive'>The Recursive Universe</option>
</optgroup>
</$select>Affichera ceci :
Generated Lists
The ListWidget can be used to generate the options for a select widget. For example, here we combine a select widget listing all the tiddlers tagged TableOfContents with a transclusion to display the text of the selected one.
<$select tiddler='$:/generated-list-demo-state'>
<$list filter='[tag[TableOfContents]]'>
<option><$view field='title'/></option>
</$list>
</$select>
<$tiddler tiddler={{$:/generated-list-demo-state}}>
<$transclude mode='block'/>
</$tiddler>Affichera ceci :
Nested Lists
This example uses a nested pair of list widgets. The outer one generates the <optgroup> elements, and the inner one generates <option> elements:
<$select tiddler='$:/generated-list-demo-nestedstate' field='type' default='text/vnd.tiddlywiki'>
<$list filter='[all[shadows+tiddlers]prefix[$:/language/Docs/Types/]each[group]sort[group]]'>
<optgroup label={{!!group}}>
<$list filter='[all[shadows+tiddlers]prefix[$:/language/Docs/Types/]group{!!group}] +[sort[description]]'>
<option value={{!!name}}><$view field='description'><$view field='title'/></$view> (<$view field='name'/>)</option>
</$list>
</optgroup>
</$list>
</$select>Affichera ceci :
Multiple Selections
This example uses the multiple keyword to specify that we should be able to select multiple items.
<$select tiddler='$:/generated-list-demo-state' field='testing' multiple size='8'>
<$list filter='[tag[TableOfContents]]'>
<option><$view field='title'/></option>
</$list>
</$select><br />
<$list filter='[list[$:/generated-list-demo-state!!testing]]'>
<$view field='title' /><br />
</$list>
Affichera ceci :
Note that the --server command is now deprecated in favour of the new ListenCommand.
See WebServer for details of TiddlyWiki's web server functionality.
Ancienne commande pour servir un wiki sur HTTP.
--server <port> <tiddler-racine> <type-du-rendu> <type-du-service> <nom-d-utilisateur> <mot-de-passe> <machine> <préfixe-des-chemins> <niveau-débogage>Les arguments sont :
- port - numéro de port sur lequel servir le contenu ; une valeur non-numérique sera interprétée comme un nom de variable d'environnement du système dont la valeur est le numéro de port (défaut : "8080")
- tiddler-racine - le titre du tiddler à afficher à la racine de l'URL (défaut : "$:/core/save/all")
- type-du-rendu - le type avec lequel le contenu du tiddler racine doit être rendu (
text/plainpar défaut) - type-du-service - le type avec lequel le contenu du tiddler racine doit être servi (
text/htmlpar défaut) - nom-d-utilisateur - le nom d'utilisateur qui servira par défaut à signer les modifications
- mot-de-passe - mot de passe optionnel permettant une authentification basique
- machine - nom de machine optionnel d'où le contenu doit être servi ("127.0.0.1" par défaut, autrement dit "localhost")
- préfixe-des-chemins - préfixe optionnel pour les chemins de fichiers
- niveau-débogage - optional debug level; set to "debug" to view request details (defaults to "none")
Si le mot de passe est spécifié en argument, le navigateur demandera à l'utilisateur d'entrer le nom d'utilisateur et le mot de passe. On notera que le mot de passe est transmis en clair, et que cette implémentation ne convient donc pas pour un usage général.
Par exemple :
--server 8080 $:/core/save/all text/plain text/html MonNomUtilisateur m0tdepa55eLe nom d'utilisateur et le mot de passe peuvent être spécifiés sous forme de chaînes vides si vous avez besoin d'indiquer le nom de machine ou le préfixe des chemins sans pour autant demander un mot de passe :
--server 8080 $:/core/save/all text/plain text/html "" "" 192.168.0.245Si vous voulez faire tourner plusieurs serveurs TiddlyWiki en même temps sur la même machine, vous devrez leur assigner chacun un port différent. Il peut être utile d'utiliser une variable d'environnement pour passer le numéro de port au process Node.js. L'exemple suivant utilise une variable d'environnement appelée "MY_PORT_NUMBER" :
--server MY_PORT_NUMBER $:/core/save/all text/plain text/html MonNomUtilisateur m0tdepa55eTermux is an open source Android application that combines a Linux system and a terminal.
Once you open Termux on your Android system, it is straightforward to install and run the Node.js flavour of TiddlyWiki from the command line.
From then on, as long as Termux is not closed, you may access your wiki anytime from your favourite Web browser pointing on the expected address and port.
note to contributors: in Termux, you may as well install git, emacs or vi, in order to edit and maintain individual tiddler files. This would probably require that you also attach a more powerful keyboard to your Android, like the Hacker's Keyboard application or a Bluetooth external device.
Notez que cette commande est expérimentale et peut changer ou être remplacée avant d'être finalisée
Initialise le champ spécifié d'un groupe de tiddlers avec le résultat de la wikification d'un tiddler template, la variable currentTiddler prenant tour à tour la valeur de chaque tiddler.
--setfield <filtre> <nom-du-champ> <titre-du-template> <type-de-rendu>Les paramètres sont les suivants :
- filtre - filtre identifiant les tiddlers cibles
- nom-du-champ - le champ à modifier ("text" par défaut)
- titre-du-template - le tiddler à wikifier dans le champ spécifié. Si manquant ou blanc, le champ spécifié est supprimé
- type-de-rendu - le type de texte à utiliser pour le rendu ("text/plain" par défaut ; "text/html" peut servir à inclure des éléments HTML)
Les « favicons » sont de petites icones que la plupart des navigateurs web affichent pour aider les utilisateurs à identifier les sites web.
favicons dans le Navigateur
Lorsque TiddlyWiki démarre dans le navigateur, il cherche un tiddler nommé $:/favicon.ico et l'utilise dynamiquement comme favicon de la page. Si vous modifiez l'image, le favicon change instantanément pour en tenir compte.
favicons sur le Serveur
Sur le serveur, la commande server servira le tiddler $:/favicon.ico sur le chemin /favicon.ico.
- Importer votre image comme tiddler (voir Images dans WikiText)
- Vous pouvez aussi faire appel à une image externe
- Ouvrez le $:/ControlPanel et sélectionnez réglage thème dans l'onglet Apparence
- Choisissez votre image à partir de la liste déroulante "Page background image"
- Réglez "Fixation de l'image de fond de page" à "Fixée à la fenêtre" pour un fond d'écran figé avec le contenu se déroulant au dessus, ou "Défile avec les tiddlers" pour le faire se déplacer (notez que les iPhone/iPad n'acceptent pas le réglage fixé pour des raisons de performance)
- Réglez "Taille de l'image de fond de page" comme suit :
- Auto permet à l'image de dépasser le cadre du fond de page
- Élargie étend l'image jusqu'à ce que sa taille couvre complètement la page. Une partie de l'image peut être tronquée
- Contenue ajuste l'image de façon à ce qu'elle s'inscrive complètement dans la page
Notez que la palette DarkPhotos est proposée pour rendre le menu latéral plus lisible avec les images de fond sombres.
Introduction
Le widget set variable affecte une valeur à une variable spécifiée. La nouvelle valeur est alors disponible par le contenu dans le cadre défini du widget.
Contenu et Attributs
Le contenu du widget <$set> forme le cadre de la valeur affectée à la variable.
| Attribut | Description |
|---|---|
| name | Le nom de la variable à affecter (par défaut du "Tiddlercourant") |
| value | La valeur à affecter à la variable si le filtre est manquant ou non vide |
| filter | Un filtre optionnel à évaluer et à affecter à la variable (voir ci-dessous) |
| emptyValue | La valeur à affecter à la variable si le filtre évalue une liste vide (voir ci-dessous) |
Affectation simple d'une variable
L'utilisation la plus simple du widget set variable affecte une chaine à une variable. L'exemple suivant affecte une chaine littérale
<$set name="maVariable" value="du texte">
<$text text=<<maVariable>>/>
</$set>Les attributs nom et valeur peuvent tous deux être transclus. Par exemple :
<$set name=<<autreVariable>> value={{gabarit!!texte}}>
<$text text=<<maVariable>>/>
</$set>Affectation conditionnel d'une variable
Cette forme du widget set variable choisit une des deux valeurs spécifiées selon que le résultat du filtre soit une liste vide ou pas. Voici un exemple affectant une variable selon que le tiddler courant se nomme "monTitreMagique" ou pas :
<$set name="maVariable" filter="[all[current]field:title[monTitreMagique]]" value="C'est magique" emptyValue="Ce n'est pas magique">
<$text text=<<maVariable>>/>
</$set>Affectation d'une liste filtrée de variable
Cette forme du widget set variable évalue le filtre et affecte le résultat à la variable sous forme de liste séparée par des espaces (utilisation des double crochets pour les titres contenant des espaces).
<$set name="maVariable" filter="[tag[Introduction]]">
<$text text=<<maVariable>>/>
</$set>| purpose | select the plugin titles that contain the input shadows |
|---|---|
| input | a selection of shadow titles |
| parameter | none |
| output | the plugins that contain the input tiddlers |
Each input title is processed in turn. If it denotes a shadow tiddler, the title of its plugin tiddler is dominantly appended to the output. Non-shadow tiddlers contribute nothing to the output.
[[$:/core/copyright.txt]shadowsource[]]
$:/core/copyright.txt $:/plugins/tiddlywiki/railroad/parser.js +[shadowsource[]]
Les tiddlers shadow sont des tiddlers chargés à partir d'un Plugins. Contrairement aux tiddlers ordinaires, ils n'apparaissent pas dans de multiple listes.
Les tiddlers shadow peuvent être remplacés par un tiddler ordinaire de même nom. Si ce tiddler est supprimé, le tiddler shadow est alors automatiquement restauré.
Les tiddlers shadow actuels sont :
Vous pouvez travailler sur un fichier TiddlyWiki dans Dropbox et publier un lien que chacun pourra visualiser en lecture seule.
- Mettez votre fichier TiddlyWiki dans un répertoire Dropbox
- Choisir l'option "Partager lien" de Dropbox pour avoir un lien d'accès publique au fichier
- Dans l'interface web de Dropbox, c'est possible en cliquant sur l'icone du lien qui apparait au survol du fichier. Dropbox ajoute aussi un élément "Lien Partagé" du menu contextuel du Finder sur OS X et de l'Explorer de Windows
- L'URL générée par Dropbox aura cette forme :
https://www.dropbox.com/s/<gobbledegook>/mywiki.html - Modifier l'URL ainsi, en préservant soigneusement le gobbledegook:
https://dl.dropboxusercontent.com/s/<gobbledegook>/mywiki.html
Le résultat est une URL "secrète" URL que vous pouvez envoyer à d'autres personnes qui auront alors la capacité de découvrir le wiki.
Il y a plusieurs façon d'être la source ou la destination d'un partage de tiddlers :
- Vous pouvez joindre un TiddlyWiki à un courriel
- Vous pouvez publier votre TiddlyWiki en ligne, et envoyer le lien dans un message :
- un lien vers l'URL du fichier lui-même
- un permalien vers un tiddler spécifique (see Permaliens)
- Un lien permaview de tous les tiddlers courant ouverts (see PermaView)
- Vous pouvez récupérer des tiddlers de TiddlyWikis publiés en ligne par d'autres en cliquant sur un lien vers le tiddler dans leur fichiers, et par un copier-coller du lien dans votre propre fichier. Un tiddler d'import apparaitra, et vous pourrez cliquer pour importer le ou les tiddler/s dans votre fichier.
- Vous pouvez partager un lien Dropbox vers votre TiddlyWiki
Create a GitHub pull request to add your name to cla-individual.md or cla-entity.md, with the date in the format (YYYY/MM/DD).
step by step
- Navigate to licenses/CLA-individual or licenses/CLA-entity according to whether you are signing as an individual or representative of an organisation
- Ensure that the "branch" dropdown at the top left is set to
tiddlywiki-com - Click the "edit" button at the top-right corner (clicking this button will fork the project so you can edit the file)
- Add your name at the bottom
- eg:
Jeremy Ruston, @Jermolene, 2011/11/22
- eg:
- Below the edit box for the CLA text you should see a box labelled Propose file change
- Enter a brief title to explain the change (eg, "Signing the CLA")
- Click the green button labelled Propose file change
- On the following screen, click the green button labelled Create pull request
Sometimes you want to protect individual tiddlers from accidental changes, either from yourself or guests to your TiddlyWiki file. Here's a couple simple approaches. Note that these do not provide hardened protection against a wilful attack.
Using a stylesheet to lock tiddlers by tag name
Create a tiddler with the following contents and tag it as $:/tags/Stylesheet :
.tc-tagged-Locked button[title="Edit this tiddler"] {display: none;}
If your TW language isn't English, then you'll need to change the text in 'title="...."' to whatever the text is when you hover over the edit button.
Now any tiddler you tag as "Locked" will have the edit button hidden. To get it back you will need to open the stylesheet tiddler and change "none" to "inline".
Using transclusion to hide your tiddler in a system tiddler
- Open your tiddler for editing.
- Select the title and copy.
- Select all the tiddler text.
- Click on the excise tool.
- In the title box, type
$:/and then paste the original title. - Use the defaults to excise and and leave a transclusion
Now you can view the contents of your original tiddler, but to edit them your will have to find the the tiddler with the $:/ prefix.
Un jeu simple développé avec TiddlyWiki et présenté dans cet article (eng).
http://zorklike.tiddlyspot.com
J'ai voulu évaluer la possibilité de créer un certain type de jeu en utilisant seulement le noyau de tiddlywiki sans plugins ou code javascript. J'ai réalisé un jeu de fiction interactif de type zork réduit à l'essentiel. C'est le jeu le plus simple que je puisse faire à ce jour, mais je pourrai faire quelques ajouts à l'avenir. il utiliser la préversion 5.1.5 car le widget action-setfield épargne un gros travail d'élaboration de macros.
Le but était de n'utiliser que les fonctions du noyau de tiddlywiki, aussi il n'y a ni plugins, ni javascript.
A single file application is a web application where all of the assets are delivered in a single static file. This means that it can be downloaded and used offline without losing functionality. It can also be hosted on almost any type of web server.
TiddlyWiki is an unusual single file application because it stores its data within the same file, and is capable of saving changes to itself.
Every single file application must also by definition be a SinglePageApplication, but the converse is not true.
As defined by Wikipedia, a SinglePageApplication is a web application that presents itself as a single HTML document that dynamically loads additional content as the user browses the site. Frequently, single page applications are carefully designed to hide their nature, appearing and functioning as an ordinary static website by respecting the address bar and the back/forward navigation controls.
Unusually, TiddlyWiki is also a SingleFileApplication.
- Prendre des notes, et servez-vous des tags et des références croisées pour les lier entre elles ;
- Utiliser les onglets, les tableaux, les listes de tiddlers partageant les mêmes tags, et les tables des matières, pour organiser vos notes ;
- Sauvegarder des signets pour vos sites web préférés (un exemple sur http://giffmex.org/experiments/tidmarks.html) ;
- Garder trace de vos tâches et rendez-vous, et organisez-les à l'aide de tags multiples (voir notre exemple de gestion de tâches) ;
- Inventorier tout ce qui vous passe par la tête : vos recettes, votre bibliothèque personnelle, vos contacts, votre collection de morceaux de musique, etc. ;
- Créer un blog ou un site web ;
- Écrire un livre ;
- Organiser vos images en galeries (voir notre exemple de galerie d'images) ;
- Partager les informations contenues dans votre TiddlyWiki avec d'autres, sous forme de fichier en ligne, de pièce jointe dans un email, d'un fichier tiddler, ou d'un lien vers un tiddler en ligne précis (essayez de cliquer sur un lien de tiddler et de le transporter depuis un TiddlyWiki vers un autre, pour voir) ;
- Faire une esquisse de dessin (éditez Motovun Jack.jpg et commencez à dessiner sur l'image, pour visualiser) ;
- Créer un assistant modal (on parle aussi de lightbox) — voir Exemple d'assistant ;
- Créer une présentation de type « transparents » ;
- Créer une base de connaissance complète en local ou en ligne, à partir d'un fichier TiddlyWiki central pointant vers d'autres fichiers TiddlyWiki (un exemple est visible à l'adresse http://recursos.giffmex.org) ;
- Créer une infographie en utilisant des tiddlers comme données (voir les infographies à l'adresse https://tiddlywiki.com/plugins/tiddlywiki/d3/).
| purpose | sort the input by text field |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as text |
! output | the input, likewise sorted into descending order |
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]sort[]]
[list[Days of the Week]!sort[]]
one two Three four +[sort[]]
[prefix[Tiddl]sort[text]]
[has[created]sort[created]limit[10]]
| purpose | sort the input by text field considering them as alphanumerics |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as alphanumerics |
! output | the input, likewise sorted into descending order |
The difference between uppercase and lowercase letters is ignored.
These examples make use of the Apple tiddler.
[list[Apple]sortan[]]
[list[Apple]!sortan[]]
App-10-A App-9-B App-10-B App-9-A +[sortan[]]
| purpose | sort the current list in the order of the list referenced in the operand |
|---|---|
| input | a list of items |
| parameter | order = a list specifying the order in which to sort the current list |
| output | all items sorted by lookup list |
These examples make use of the Days of the Week tiddler.
10 6 4 9 3 2 8 +[sortby[1 2 3 4 5 6 7 8 9 10]]
Friday Tuesday Monday Thursday Sunday +[sortby{Days of the Week!!list}]
1 Mon 5 Fri 4 Tue Sun 2 +[sortby{Days of the Week!!short}]
| purpose | sort the input by text field, treating upper and lower case as different |
|---|---|
| input | a selection of titles |
| parameter | F = the name of a field, defaulting to title |
| output | the input, sorted into ascending order by field F, treating field values as text |
! output | the input, likewise sorted into descending order |
These examples make use of the Days of the Week tiddler.
one two Three four +[sortcs[]]
one two Three four +[!sortcs[]]
Du fait des origines britanniques de TiddlyWiki, sa documentation anglaise emploie l'orthographe britannique de préférence à l'orthographe US.
Les mots comme "customise" sont orthographiés "-ise" et pas "-ize".
Les acronymes techniques standard sont écrits en majuscules, sans points : "HTML", et pas "html" ou "H.T.M.L."
Éviter les abréviations arbitraires de mots ou de phrases. Mais les abréviations suivantes sont acceptables :
| Abbréviation | Signification | Notes |
|---|---|---|
| e.g. | par exemple | avec un point après chaque lettre |
| i.e. | c'est à dire | avec un point après chaque lettre |
| etc | ainsi de suite | sans point |
| purpose | select a delimited prefix from each input title |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters marking the end of the prefix |
| output | the prefix, up to and including S, of each input title |
Each input title is processed in turn.
- A title that contains
Scontributes everything up to and includingS. - A title that doesn't contain
Ssimply contributes itself to the output.
Contributions are dominantly appended to the output.
The table-of-contents macros use this operator with / as the parameter.
The Stanford Javascript Crypto Library is a project by the Stanford Computer Security Lab to build a secure, powerful, fast, small, easy-to-use, cross-browser library for cryptography in Javascript.
During startup, TiddlyWiki executes any ActionWidgets found in tiddlers with the following system tags:
- (executed on all platforms)
- (only executed when running in the browser)
- (only executed when running under Node.js)
Startup actions are useful for customising TiddlyWiki according to environmental factors such as the screen size. For example, the following action widgets when placed in a tiddler tagged will cause the sidebar to be hidden by default when the screen width is less than 1000 pixels:
<$reveal type="lt" state="$:/info/browser/screen/width" text="3000">
<$action-setfield $tiddler="$:/state/sidebar" $value="no"/>
</$reveal>
<$reveal type="gteq" state="$:/info/browser/screen/width" text="3000">
<$action-setfield $tiddler="$:/state/sidebar" $value="yes"/>
</$reveal>Note that global macros are not available within startup action tiddlers by default. If you need to access them then you'll need to explicitly include them with an import pragma at the top of the tiddler:
\import [[$:/core/ui/PageMacros]] [all[shadows+tiddlers]tag[$:/tags/Macro]!has[draft.of]]The StateMechanism in TiddlyWiki is at the heart of how complex user interfaces can be built from WikiText.
In the browser, the TiddlyWiki display is produced by dynamically rendering the tiddler $:/core/ui/PageTemplate. Through various transclusions and other widgets it renders the entire user interface. The dynamic rendering is accomplished by a mechanism called "binding": any changes to the tiddlers in the store are dynamically reflected in the browser display.
The stack of templates that make up the TiddlyWiki display are complex but we'll focus on the line that displays the main story column:
<$list filter="[list[$:/StoryList]]" history="$:/HistoryList" template="$:/core/ui/ViewTemplate" editTemplate="$:/core/ui/EditTemplate" storyview={{$:/view}} />Breaking down the attributes applied to the list widget:
- filter: selects the list of tiddlers in the
listfield of the tiddler $:/StoryList. If a tiddler is added or removed from that list then it is automatically reflected in the displayed list - history: references the tiddler to be used to store the history stack (see the NavigationMechanism)
- template: identifies a template tiddler to be used for rendering each tiddler in the list
- editTemplate: identifies a different template tiddler to be used for rendering tiddlers that are in draft mode
- storyview: specifies the story view to be used (eg classic, or zoomin)
The $:/StoryList tiddler is an example of a StateTiddler: a tiddler that is used to hold the state of the user interface. Changes to the user interface are made indirectly, by changing the underlying state tiddlers, and letting TiddlyWiki ripple the changes through the user interface.
Note how this approach makes the open tab in the sidebar very easy to implement: it is just another list widget referencing the same state tiddler, but with a different template:
<$list filter="[list[$:/StoryList]]" history="$:/HistoryList" storyview="pop">
<$button message="tm-close-tiddler" class="tc-btn-invisible tc-btn-mini">×</$button> <$link to={{!!title}}><$view field="title"/></$link>
</$list>Now consider the implementation of the info panel within the tiddler template. We want to be able to toggle the info panel open and closed, which means that we must track its current state in a tiddler.
However, we can't track the state in a tiddler called, say, $:/InfoPanelState because every tiddler would share the same state; changing the value of the tiddler would affect all tiddlers displayed in the story.
The solution is to dynamically generate a unique title for each state tiddler that we need. We need to ensure that the same state tiddler title is generated each time a user interface element is rendered. To do that, we append together tokens representating each of the stack of transclusions that led to the current rendering location. Then that string of symbols is hashed to a simple numeric value.
The process of generating a state tiddler title is encapsulated in the qualify macro.
The "story river" (sometimes abbreviated to "story") is the sequence of tiddlers in the main column of the display.
=> tiddler en cours d'affichage ou d'édition.
When a tiddler is viewed or edited, then within its branch of the widget tree, the storyTiddler variable contains the title of that tiddler.
The default view template and edit template initialise storyTiddler to the value of the currentTiddler variable. This in turn will have been set by a $list widget in the relevant part of the page template.
storyTiddler is undefined outside the story river, such as in the sidebar.
<ol>
<$list filter="[prefix[J]]">
<li><<currentTiddler>>, <<storyTiddler>></li>
</$list>
</ol>| purpose | select the names of all the story views |
|---|---|
| input | ignored |
| parameter | none |
| output | the name of each story view |
| purpose | apply JavaScript string encoding to a string |
|---|---|
| input | a selection of titles |
| output | the input with JavaScript string encodings applied |
The following substitutions are made:
| Character | Replacement |
|---|---|
\ | \\ |
" | \" |
\r (carriage return) | \\r |
\n (line feed) | \\n |
\x08 (backspace) | \\b |
\x0c (form feed) | \\f |
\t (tab) | \\t |
| Characters from 0x00 to 0x1f and characters from 0x80 to 0xffff | \\u#### where #### is four hex digits |
Also see the jsonstringify Operator.
TiddlyWiki5 fournit plusieurs fonctionnalités qui vous aideront à structurer les informations sous forme de tiddlers, et à modéliser les relations entre eux :
You can use this construction to cause the wrapped content to be assigned specified CSS classes or styles:
@@.myStyle
* List One
* List Two
@@
Affichera ceci :
- List One
- List Two
... Génération du HTML :
<ul class="myStyle"><li>List One</li><li>List Two</li></ul>
Similar syntax is used to assign styles. For example:
@@background-color:red;
* List One
* List Two
@@
Affichera ceci :
- List One
- List Two
... Génération du HTML :
<ul style="background-color:red;"><li>List One</li><li>List Two</li></ul>
Multiple styles and classes can be mixed. For example:
@@.tc-tiddler-frame
@@width:400px;
Some text
@@
Affichera ceci :
Some text
... Génération du HTML :
<p class="tc-tiddler-frame" style="width:400px;">Some text </p>
The following core macros make it easy to specify alternative browser-specific properties when constructing a stylesheet tiddler:
<<box-shadow shadow>>- for the
x-box-shadowproperties <<filter filter>>- for the
x-filterproperties <<transition transition>>- for the
x-transitionproperties <<transform-origin origin>>- for the
x-transition-originproperties <<background-linear-gradient gradient>>- for the
x-linear-gradientvalues of thebackground-imageproperty
The following macros are documented separately:
All these macros are defined in the $:/core/macros/CSS tiddler.
| purpose | select titles from the operand interpreted as a filter expression |
|---|---|
| input | a selection of titles passed as input to the subfilter |
! input | a selection of titles passed as input to the subfilter |
| parameter | S = a filter expression |
| output | the selection of titles returned from the subfilter S |
! output | those input titles that are not returned from the subfilter S |
New in: 5.1.18 Note that the subfilter operator was introduced in version 5.1.18 and is not available in earlier versions.
<$set name="myFilter" value="[tag[one]]">
<$list filter="[all[tiddlers]subfilter<myFilter>]">
...| purpose | select all fields present in the selected tiddlers within a plugin |
|---|---|
| input | a selection of tiddler titles |
| parameter | P = the title of a plugin |
| output | all field names present in the selected tiddlers within the plugin named P |
| purpose | filter the input titles by how they end |
|---|---|
| input | a selection of titles |
| parameter | S = a string of characters |
| output | those input titles that end with S |
! output | those input tiddlers that do not end with S |
In looking for matches for S, capital and lowercase letters are treated as different.
The system tag $:/tags/KeyboardShortcut defines the tagged Tiddler as a Keyboard Shortcut Tiddler, a container for actions that get triggered when its corresponding Keyboard Shortcut Descriptor in its key field matches a keyboard combination executed by the User
The system tag $:/tags/RawMarkup marks plain text tiddlers to be included as raw markup at the bottom of the <head> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect.
The system tag $:/tags/RawMarkupWikified marks wikified tiddlers to be included as raw markup at the bottom of the <head> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
New in: 5.1.18 The system tag $:/tags/RawMarkupWikified/BottomBody marks wikified tiddlers to be included as raw markup at the bottom of the <body> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
New in: 5.1.18 The system tag $:/tags/RawMarkupWikified/TopBody marks wikified tiddlers to be included as raw markup at the top of the <body> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
New in: 5.1.18 The system tag $:/tags/RawMarkupWikified/TopHead marks wikified tiddlers to be included as raw markup at the top of the <head> section in the generated HTML file.
Note that the wiki must be saved and reloaded in order for a raw markup tiddler to take effect. Also note that global macros are not available by default within raw markup tiddlers; you can use the ImportVariablesWidget to explicitly import them.
The system tag $:/tags/SideBarSegment marks sidebar segments
Note: You can rearrange the segments by drag-and-dropping the titles inside the tag pill
The system tag $:/tags/StartupAction/Browser marks actions only executed when running in the browser
Les tags système sont employés pour donner un comportement particulier aux tiddlers.
Tags système disponibles
Liste des tags système disponibles
- Éléments à placer au sommet du déroulé
- Recherche Avancée +/- d'Onglets
- Créer un Gabarit d'Alerte
- Éléments à placer en queue de déroulé
- +/- Onglets
- /Avancé +/- Options
- /Apparence +/- Options
- /Info +/- Options
- /Paramétrage +/- Options
- /Barres d'outils +/- Options
- Tiddlers, Édition Gabarit +/- zones
- Tiddlers, Édition +/- de boutons accessibles
- Créer un Gabarit d'Export
- Ajout au choix déroulant des ex. de filtres en recherche avancée
- Ajouter des images (noyau)
- Ajouter des macros globales
- Menu latéral/Plus +/- Options
- Menu latéral/Outils +/- Options
- Page, Gabarit +/- de zones
- Couleur +/- de palettes
- Plugin +/- de bibliothèques
- Intégrer les balises brutes à la génération du fichier HTML
- Créer un Gabarit pour les résultats de recherche
- Menu latéral +/- d'Onglets
- Ajout d'un tiddler feuille de style CSS
- Tiddler +/- Onglets
- Tiddler /Outils +/- Options
- +/- Menu Haut-Gauche
- +/- Menu Haut-Droit
- Tiddlers, Affichage Gabarit +/- zones
- Tiddlers, Affichage +/- de boutons accessibles
Tags système utilisés
Listes des tags système en cours d'utilisation dans ce wiki :
Un tiddler système correspond à tout tiddler dont le titre commence par $:/ ; de tels tiddlers sont automatiquement ignorés de plusieurs opérations. Ils n'apparaissent pas dans les listes des résultats de recherche, mais une liaison directe vers l'un d'eux fonctionne de façon classique.
TiddlyWiki considère tout comme un tiddler , y compris ses composants internes et sa configuration. Ainsi, même un TiddlyWiki, apparemment vide, contient, en fait, des dizaines de tiddlers nécessaires à son bon fonctionnement. L'emploie de tiddlers système évite les méprises des utilisateurs occasionnels.
Les tiddlers système actuels sont :
TiddlyWiki fournit plusieurs macros permettant de générer une arborescence de liens vers des tiddlers à partir de l'analyse des tags :
toc- Un arbre simple
toc-expandable- Un arbre dont les branches peuvent être déployées ou rétractées
toc-selective-expandable- Un arbre dont les branches non-vides peuvent être déployées ou rétractées
toc-tabbed-internal-navettoc-tabbed-external-nav- Une navigation en deux panneaux :
- sur la gauche, une arborescence extensible sélectivement se comportant comme un ensemble d'onglets verticaux
- sur la droite, le contenu du tiddler sélectionné par l'utilisateur dans l'arborescence
La différence entre ces deux derniers provient de ce qu'il advient lors d'un clic de l'utilisateur sur un lien du panneau droit :
toc-tabbed-internal-nav- Le tiddler cible s'affiche dans le panneau droit, remplaçant le tiddler contenant le lien
toc-tabbed-external-nav- Le tiddler cible s'affiche de façon classique (selon la configuration de l'affichage du déroulé par l'utilisateur)
Structure
Le premier niveau de l'arborescence est constitué de tiddlers qui portent une étiquette particulière, appelée tag racine. Les tiddlers marqués par l'un de ceux-là forment le niveau suivant, et ainsi de suite.
À chaque niveau, les tidllers peuvent être ordonnés
via le champ list de leur tiddler tag parent. Ils peuvent aussi être triés en paramétrant la macro sort
L'arborescence affiche le champ caption du tiddler s'il en a un, sinon son titre.
Chaque tiddler est affiché comme un lien, mais vous pouvez règler ceci en affectant la valeur no au champ toc-link du tiddler. Ainsi dans cet exemple, le tiddler SecondThree est affecté de la sorte. Cliquer sur un tel tiddler dans l'arborescence permettra de déployer ou rétracter sa branche.
La table des matières génère une liste HTML ordonnée. Les balises <ol> ont toujours la classe tc-toc. Les éléments d'arborescences déployables ont la classe additionnelle tc-toc-expandable. Les arborescence déployables sélectivement (dont celles du deuxième panneau de navigation) sont munies de tc-toc-selective-expandable.
Pour intégrer une table des matières dans le menu latéral, voir un nouvel onglet dans le menu latéral.
Paramètres
- tag
- Le tag racine indiquant le premier niveau de l'arborescence
- sort
- Une extra étape de filtre optionelle, e.g.
sort[title]
Ces deux paramètres sont combinés en une seule expression de filtre de cette façon :
[tag[$tag$]$sort$]
toc-tabbed-internal-nav et toc-tabbed-external-nav ont, en sus, d'autres paramètres :
- selectedTiddler
- Le titre du tiddler d'état attribué au tiddler en cours sélectionné, par défaut
$:/temp/toc/selectedTiddler. Il est recommandé d'employer un tiddler système - unselectedText
- Le texte affiché quand aucun tiddler n'est sélectionné dans l'arborescence
- missingText
- Le texte affiché si le tiddler sélectionné est manquant
- template
- De manière optionnelle, le titre du tiddler gabarit lors de la transclusion du tiddler sélectionné dans le panneau de droite
Cet exemple découle de tables des matières issues du tag racine Contents.
Vous pourrez découvrir leurs structures en cliquant sur ces tags pilules :
Cet autre exemple avec onglets emploie, en plus, la table des matières réelle de cette documentation.
<div class="tc-table-of-contents">
<<toc "Contents">>
</div>La macro TableOfContents (Table des Matières) produit une arborescence hiérarchique de tiddlers, en se basant sur leurs tags.
Les entrées de premier niveau de la table des matières sont définies par un tag racine. Les sous-entrées de chacune de ces entrées sont taguées avec le titre de l'entrée. Les entrées peuvent être triées à l'aide du champ list du tiddler de tag correspondant, comme décrit dans Tagging.
Le libellé utilisé pour chaque entrée est tiré du champ caption s'il est présent ; dans le cas contraire, c'est le titre (champ title) qui est utilisé.
Les entrées sont affichées sous forme de liens vers le tiddler correspondant, à moins que le tiddler contienne un champ toc-link avec la valeur no. Dans les exemples ci-dessous, l'entrée SecondThree est configurée ainsi, de manière à ne pas apparaître comme un lien.
Il existe plusieurs variantes de cette macro :
<<toc>>produit une arborescence hiérarchique de liens simple<<toc-expandable>>produit une arborescence de liens développable<<toc-selective-expandable>>produit une arborescence de liens développable où les boutons développer / contracter ne sont affichés que pour les entrées qui possèdent des nœuds fils
Les macros génèrent des listes HTML ordonnées. Les éléments <ol> bénéficient de la classe tc-toc, ceux de la variante expandable bénéficiant également de la classe tc-toc-expandable tandis que ceux de la variante selective expandable bénéficient de la classe tc-toc-selective-expandable.
Paramètres
| Position | Nom | Description | Défaut |
|---|---|---|---|
| 1re | tag | Le tag racine qui identifie le premier niveau de la hiérachie | |
| 2e | sort | Sous-fitre optionnel de tri (par exemple sort[title]) |
Les paramètres tag et sort sont combinés pour construire une expression de filtre de la forme :
[tag[$tag$]$sort$]Exemples
Dans les exemples suivants, les entrées de premier niveau de la table des matières sont définies par leur tag racine Contents. Les sous-entrées sous chacune de ces entrées sont taguées avec le titre de leur parent, ici First, Second, Third, et Fourth. Au niveau du dessous, seul SecondThree comporte des sous-entrées.
Voici la structure des tags, affichée à l'aide de pastilles de tag cliquables :
Pour des instructions sur la manière d'ajouter une table des matières dans la barre latérale, voyez : Comment ajouter un nouvel onglet dans la barre latérale.
Concepts de base
TiddlyWiki5 forme les tableaux au moyen du signe barre verticale |, de cette façon :
|!Cell1 |!Cell2 |
|Cell3 |Cell4 |Le point d'exclamation marque l'entête des cellules:
| Cell1 | Cell2 |
|---|---|
| Cell3 | Cell4 |
L'alignement horizontal
L’alignement horizontal des cellules du tableau est contrôlé par l'insertion d'un espace avant/après le contenu de la cellule. Par exemple:
|Contenu aligné à gauche |
| Contenu aligné à droite|
| Contenu centré |
|+++ Une très grande cellule pour vous montrer l'alignement dans la colonne +++|Cet exemple donne ceci :
| Contenu aligné à gauche |
| Contenu aligné à droite |
| Contenu centré |
| +++ Une très grande cellule pour vous montrer l'alignement dans la colonne +++ |
L'alignement vertical
L’alignement vertical des cellules du tableau est contrôlé par l'insertion, comme premier caractère de la cellule, soit d'un ^ pour un alignement en haut ou un , pour un alignement en bas. La combinaison avec l'alignement horizontal reste valable.
Exemple :
|^haut gauche |^ haut centré |^ haut droit|
|milieu gauche | milieu centré | milieu droit|
|,bas gauche |, bas centré |, bas droit|Ce qui affiche :
| :: :: | haut gauche | haut centre | haut droit |
| :: :: :: | milieu gauche | milieu centre | milieu droit |
| :: :: | bas gauche | bas centré | bas droit |
Si vous voulez afficher un ^or a , comme premier caractère d'une cellule alignée à gauche, vous ferez appel au html-escaping/ échappement-html. Voir, à ce sujet la Mise en forme avec WikiText.
^ | ^ |
, | , |
La fusion des cellules
Pour fusionner le contenu de la cellule située au dessus utiliser ~. Pour fusionner avec celle de gauche < et > pour celle de droite. Par exemple:
|Cell1 |Cell2 |Cell3 |Cell4 |
|Cell5 |Cell6 |Cell7 |<|
|Cell5 |~|Cell7 |Cell8 |
|>|Cell9 |Cell10 |Cell11 |affiche:
| Cell1 | Cell2 | Cell3 | Cell4 |
| Cell5 | Cell6 | Cell7 | |
| Cell5 | Cell7 | Cell8 | |
| Cell9 | Cell10 | Cell11 | |
Classes de tableau, légendes, en-têtes et pieds de tableau
Des classes CSS, des légendes, des en-têtes et pieds de tableau peuvent être spécifiés comme pseudo-lignes spéciales :
|maclasse autreClass|k
|Ceci est une légende |c
|Cell1 |Cell2 |
|Cell3 |Cell4 |
|Entête|Entête|h
|Pied|Pied|faffiche :
| Cell1 | Cell2 |
| Cell3 | Cell4 |
| Entête | Entête |
| Pied | Pied |
The tabs macro presents a selection of tiddlers as a set of tabs that the user can switch between.
The tabs display the caption field of a tiddler if it has one, or the tiddler's title otherwise. If specified, the tabs display the tooltip field of a tiddler as the respective button tooltip.
By default the tabs are arranged horizontally above the content. To get vertical tabs, set the class parameter to tc-vertical.
Parameters
- tabsList
- A filter selecting which tiddlers to include
- default
- The title of the tiddler whose tab is to be selected by default
- state
- The prefix for the title of a state tiddler for noting the currently selected tab, defaulting to
$:/state/tab. It is recommended that this be a system tiddler - class
- Additional CSS classes for the generated
divelements. Multiple classes can be separated with spaces - template
- Optionally, the title of a tiddler to use as a template for transcluding the content of the selected tab
- buttonTemplate
- Optionally, the title of a tiddler to use as a template for transcluding the content of the button for the selected tab
- retain
- Optionally, "yes" specifies that the content of the tabs should be retained when switching to another tab, avoiding re-rendering it (this can be useful to avoid video or audio sources unexpectedly resetting)
Within the template, the title of the selected tab is available in the currentTab variable.
The currentTiddler variable is not affected by the tabs macro. This can put you in trouble if the list of tabs includes tiddlers that depend on the value of the currentTiddler, for example tiddlers listing children based on its own name. To overcome this problem you can use a TemplateTiddler like the following:
<$tiddler tiddler=<<currentTab>>>
<$transclude mode="block" />
</$tiddler><<tabs "SampleTabOne SampleTabTwo SampleTabThree SampleTabFour" "SampleTabOne" "$:/state/tab1">><<tabs "[tag[sampletab]]" "SampleTabTwo" "$:/state/tab2" "tc-vertical">><<tabs "[tag[sampletab]nsort[order]]" "SampleTabThree" "$:/state/tab3" "tc-vertical">>La macro tabs affiche une liste de tiddlers sous forme d'onglets. L'utilisateur peut passer d'un onglet à l'autre en cliquant. Les onglets sont étiquetés avec le titre du tiddler correspondant, sauf si un champ caption est présent, auquel cas c'est celui-ci qui est utilisé.
Par défaut, les onglets sont disposés horizontalement, le contenu étant affiché en-dessous. Vous pouvez aussi disposer les onglets verticalement en passant en paramètre la classe tc-vertical.
Paramètres
| Position | Nom | Description | Défaut |
|---|---|---|---|
| 1re | tabsList | Filtre indiquant les tiddlers à afficher | |
| 2e | default | Nom du tiddler contenant l'onglet qui s'affichera par défaut | |
| 3e | state | Chaîne de caractères permettant de distinguer plusieurs ensembles d'onglets présents dans le même tiddler (l'utilisation du préfixe des tiddlers système est recommandée) | $:/state/tab |
| 4e | class | Classes CSS supplémentaires pour les trois DIVs imbriquées qui construisent les onglets (vous pouvez indiquer plusieurs classes en les séparant avec des espaces) | |
| 5e | template | Un tiddler template optionnel via lequel le contenu de l'onglet doit être rendu |
À l'intérieur du template, le titre de l'onglet courant est accessible via la variable currentTab. La variable currentTiddler n'est pas modifiée par la macros tabs.
Exemples
Voici quelques exemples d'utilisation de la macro tabs. Notez que l'édition française de la documentation utilise le champ caption pour faire apparaître le titre de l'onget en Français :
<<tabs "SampleTabOne SampleTabTwo SampleTabThree SampleTabFour" "SampleTabThree" "$:/state/tab1">>
<<tabs "[tag[sampletab]]" "SampleTabTwo" "$:/state/tab2" "tc-vertical">>Voici le troisième de nos onglets d'exemple.
Voici le deuxième de nos onglets d'exemple.
Exercice : comment faire en sorte que cette deuxième liste soit triée ? Indice : lisez le tiddler Tagging jusqu'au bout.
The tag macro generates a tag pill for a specified tag.
Parameters
- tag
- The title of the tag, defaulting to the current tiddler
| purpose | filter the input by tag |
|---|---|
| input | a selection of titles |
| suffix | S = New in: 5.1.14 optional strict flag |
| parameter | T = the title of a tag |
| output | those input tiddlers that have tag T |
! output | those input tiddlers that do not have tag T |
The output is sorted using the tag's list field and the tiddlers' list-before and list-after fields.
The behaviour when T is empty depends on the settings of the S optional suffix:
- if
Tis missing andSis either missing or set to "loose", then the output oftagis empty, and the output of!tagis a copy of the input. - New in: 5.1.14 if
Tis missing andSis set to "strict", then the output of bothtagand!tagis a copy of the input
[tag[task]]
[tag[task]!tag[done]]
[!tag[task]]
[all[shadows]tag[$:/tags/Stylesheet]]
The tag-pill macro generates a static tag pill showing a specified tag, but without the dropdown action provided by the tag Macro.
Parameters
- tag
- The title of the tag
- element-tag
- The element name to be used for the pill (defaults to "span")
- element-attributes
- Additional attributes for the pill element
- actions
- Action widgets to be triggered when the pill is clicked. Within the text, the macro parameter tag contains the title of the selected tag.
Étiqueter un tiddler consiste à assigner par un tag à un tiddler une catégorie de votre choix (voir Créer et éditer des tiddlers pour des instructions sur la manière de taguer). Par exemple, les tiddlers représentant des individus pourraient être étiquetés par les tags ami, famille, collègue, etc. pour indiquer leur relation avec l'auteur. Plusieurs tags peuvent être appliqués au même tiddler.
Le fait d'étiqueter les tiddlers vous procure de nombreux moyens supplémentaires de visualiser, parcourir, et organiser vos informations :
- Les pastilles colorées pour chaque tag d'un tiddler vous donnent accès à tous les autres tiddlers de même tag, ainsi qu'au tiddler correspondant au tag lui-même.
- L'onglet Étiqueté dans le panneau d'informations du tiddler (accessible en cliquant sur le bouton ) vous donne les liens vers tous les tiddlers tagués avec le titre du tiddler courant.
- Vous pouvez utiliser l'onglet Tags dans l'onglet Plus de la barre latérale pour visualiser tous vos tags et accéder à vos tiddlers étiquetés.
- Vous pouvez utiliser des filtres pour créer des listes de tiddlers selon leurs tags, puis afficher toute combinaison de champs souhaitée. Par exemple, vous pouvez créer une liste qui montre à la fois le titre et le texte de tous les tiddlers étiquetés Glossaire. Ces listes peuvent être formatées à votre goût : avec des puces, des nombres, ou séparées par des virgules, etc.
- Les tags « système » peuvent servir à personnaliser la mise en forme des tiddlers et de la page TiddlyWiki dans son ensemble. Voir les instructions correspondantes dans Personnalisation de la mise en forme de la page et des tiddlers.
Encore deux choses que les tags permettent de faire :
Affecter des couleurs et des icones à un tag
Vous pouvez utiliser le gestionnaire de tags, présent dans l'onglet Tags de l'onglet Plus de la barre latérale, pour affecter une couleur de fond et/ou une icone à un tag.
- Les couleurs peuvent être affectées à un tag soit en spécifiant la valeur CSS de la couleur dans la fenêtre supérieure dans la colonne des couleurs, soit en choisissant une couleur à partir du menu déroulant proposé.
- Les icones peuvent être affectées à un tag en cliquant sur le bouton dans la colonne des icones et en choisissant une des icones proposées.
Utiliser des champs list pour ajuster l'ordre des listes par tag
Si vous voulez créer une liste de tiddlers à l'aide d'un filtre à partir d'un tag qu'ils ont en commun, en les triant selon un ordre particulier plutôt que selon l'ordre alphabétique par défaut, vous pouvez créer un champ appelé 'list' dans le tiddler du tag lui-même, et y ajouter les titres des tiddlers à ordonner dans l'ordre désiré. TiddlyWiki triera les listes de tiddlers tagués dans l'ordre de priorité suivant :
- Premièrement, les tiddlers placés dans le champ list du tiddler de tag seront placés dans une nouvelle liste dans le même ordre
- Deuxièmement, tout tiddler sans place fixe mais disposant d'un champ list-before sera placé avant le tiddler indiqué dans le champ
- (si le champ list-before est vide, alors le tiddler sans place prédéfinie sera placé au début de la liste)
- Troisièmement, tout tiddler sans place prédéfinie disposant d'un champ list-after sera placé juste après le tiddler indiqué dans le champ
- Enfin, tout tiddler n'ayant toujours pas de place prédéfinie sera placé à la fin de la liste
| purpose | find the tiddlers that have the input tags |
|---|---|
| input | a selection of tags |
| parameter | none |
| output | the titles of any tiddlers that carry the input tags |
Each input tag is processed in turn. The list of tiddlers carrying that tag is generated, sorted, and then dominantly appended to the operator's overall output.
[[task]tagging[]]
[tag[task]]Concepts task +[tagging[]]
[all[current]tagging[]]
| purpose | select all tags of the input tiddlers |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | all the tags carried by the input tiddlers |
Each input title is processed in turn. The corresponding tiddler's tags are retrieved (in order of appearance in the tags field) and then dominantly appended to the operator's output.
Un tiddler tag correspond à tout tiddler utilisé comme tag.
Pour connaître quels tiddlers sont étiquetés par un tiddler tag sélectionné. Aller dans son panneau d'information et choisir Étiquetage, ou cliquez :
- ,
- puis Étiquetage
Un tag peut être utilisé sans nécessairement correspondre à un tiddler tag.
TiddlyWiki5 peut servir de système de gestion de tâches simple sans personnalisation supplémentaires. L'idée est que les tâches soient taguées avec task, celles étant terminées portant également le tag done. De cette manière, il est très simple de générer des listes de tâches.
Tâches à effectuer
Tâches terminées
This is a version of the TaskManagementDemo enhanced with the ability to drag and drop the task list to re-order them.
Outstanding tasks
Drag the tasks to re-order them
Completed tasks
(Listed in reverse order of completion)
Lors de la rédaction d'un tiddler d'apprentissage, commencez par planifier la route des informations que vous souhaitez présenter. Ce doit être un cheminement simple, logique, progressif, sans retour en arrière ou référence à suivre.
Employez cette méthode, même lors d'expressions indépendantes : toujours aller de la cause à l'effet, de l'ancien ou connu vers le nouveau ou l'inconnu. Une phrase technique claire contient rarement plus d'une idée. Elle évite donc les informations entre parenthèses. De même, garder une structure de paragraphe simple. Une présentation linéaire est souvent plus facile à comprendre que si elle est hiérarchisée.
Il est souvent possible de simplifier une phrase sans changer sa signification, simplement en ajustant son vocabulaire ou sa structure grammaticale. "le processus de la macro est exécutée" signifie simplement "La macro s'exécute". "Votre attente pourrait être ..." signifie simplement "Vous pourriez attendre ...".
Préférez la voix active par défaut : "Jane créé un tiddler" plutôt que "un tiddler est créé par Jane". La voix passive peut être utile si vous voulez focaliser l'attention du lecteur sur l'action elle-même ou sur son résultat : "un tiddler est créé". Mais il est souvent plus clair d'aller de la cause à l'effet et dire en voix active, "Cela créé un tiddler".
La documentation présente souvent deux éléments en parallèle par similarité ou par différence. Le lecteur pourra plus facilement appréhender des concepts si vous employez la même structure de phrase pour chacun. Mais c'est contrebalancé par la nécessité de rompre la monotonie.
Préférez les instructions précises aux discours verbeux. Si quelque chose a un nom, l'utiliser. Si quelque chose n'a pas de nom, lui attribuer un tiddler.
Un tiddler gabarit n'est pas vraiment un type de tiddler, c'est un rôle dans lequel un tiddler peut être utilisé.
Les gabarits sont un moyen de réutiliser différentes portions de WikiTexte.
Transclure par un gabarit étend les fonctionnalités de base de la Transclusion en combinant deux tiddlers :
- Un tiddler gabarit contenant le WikiTexte à afficher. Il peut contenir des transclusions se référant aux champs du tiddler en cours
- Un tiddler cible qui indique quel tiddler sera considéré comme en cours lors des calculs de références des champs
Le meilleur exemple de modélisation est le flux principal des tiddlers ouverts de TiddlyWiki. Chaque tiddler du déroulé principal est affiché via un Gabarit d'affichage qui spécifie le rendu de chaque champ.
Voir la Transclusion par Gabarits pour plus de détails.
- Avec TiddlyWiki, vous pouvez organiser vos notes selon vos préférences, pas selon celle des autres. Vos notes se conforment à votre façon de penser et personne ne vous impose une hiérarchie prédéfinie de carnets de notes ou d'onglets.
- L'approche non-linéaire de TiddlyWiki vous donnera l'occasion de penser à vos informations d'une façon effectivement nouvelle et utile.
- Retrouver ses notes dans TiddlyWiki est ultra-rapide.
- Il existe de nombreux moyens de personnaliser et d'adapter tous les aspects de TiddlyWiki.
- TiddlyWiki est libre et gratuit, et compatible avec toutes les plates-formes. N'importe quel navigateur web pourra l'ouvrir. Pour l'utiliser, il n'est pas nécessaire d'acquérir une application coûteuse, ni de payer un abonnement.
- Les fichiers TiddlyWiki facilitent le partage d'informations. Il existe une multitude de manières de partager vos informations depuis TiddlyWiki.
- Avec TiddlyWiki, vos informations vous appartiennent, et vous les stockez où vous voulez — sur notre appareil, sur une clé USB, dans Dropbox, sur votre serveur.
- TiddlyWiki propose un nombre toujours croissant de plugins, thèmes, widgets, et langages.
- La communauté en ligne de TiddlyWiki est bienveillante, et fera de son mieux pour vous apporter l'aide dont vous avez besoin.
- Si vous êtes programmeur, vous trouverez encore plus de façons de faire joujou avec TiddlyWiki. Avec TiddlyWiki, plus on en sait, plus on s'amuse.
The Text-Slicer edition of TiddlyWiki contains tools to help advanced users slice long texts up into individual tiddlers.
Une RéférenceTexte identifie le bloc de texte d'un tiddler qui peut être récupéré ou modifié selon le contexte.
Les références texte sont composées de multiple parties, dont plusieurs peuvent être optionnelles :
tiddlerTitle- Le champ texte d'un tiddler spécifiétiddlerTitle!!field- un champ de tiddler (eg,modified,modifier,typeetc)!!field- un champ du tiddler en courstiddlerTitle##propertyIndex- extrait la propriété nommée d'un Tiddler Data
Les références texte peuvent être utilisées à plusieurs endroits :
- Comme paramètres indirectes dans les Filtres (eg,
<$list filter="[tag{MonTag!!nom}]"/>) - Comme attributs indirects d'un élément ou d'un widget (eg,
<$widget attrib={{Title!!description}}/>) - comme l'opérateur d'une transclusion (eg,
{{MyTiddler!!title}}) - Comme attribut
statedu RevealWidget et du LinkCatcherWidget
Introduction
The text widget displays plain text without parsing it as WikiText, opposite of WikifyWidget.
Content and Attributes
The content of the <$text> widget is not used.
| Attribute | Description |
|---|---|
| text | The text to display |
Example
<$vars string="//italic//">
* <<string>>
* <$text text=<<string>>/>
</$vars>
Affichera ceci :
- italic
- //italic//
The text-test field of this tiddler has a field value: <$text text={{!!text-test}}/>
It displays in its normal WikiText format as: {{!!text-test}}
Affichera ceci :
The text-test field of this tiddler has a field value: e=mc^^2^^
It displays in its normal WikiText format as: e=mc2
Introduction
A number of extended filters are necessary to manipulate lists.
The first set of filters are designed to move items from the tail of the list and insert them at specified locations in the list. Items are often appended to the list before using these filters. In general, these filters accept a suffix specifying the number of items to move (default to 1.)
A second set of filters are designed to either add or remove from the list, a selected range of items from an array. These filters are best used with a reference to an array, stored in a field or data index elsewhere in the wiki (they may be used with a simple list of items, provided the items do not include white space.) In general, these filters accept a suffix specifying the number of items to move (default to All.)
Examples
In this example we shall populate the 'DataIndex' index of the tiddler 'MyData' with the names of the days of the week, then clear this list.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $filter="[list[Days of the Week]]"/>
Get days-of-the-week
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $filter="[[]]"/>
Clear
</$button>
{{ListopsData}}Affichera ceci :
DataIndex:
In this example we shall slice the populated list from the 'DaysOfTheWeek' index of the tiddler 'MyData' in order to insert items before and after a marker item (Wednesday) that are first appended to the list.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="one two +[putbefore:2[Wednesday]]"/>
Put 2 Items Before Wednesday
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="four five +[putafter:2[Wednesday]] three +[putbefore[Wednesday]]"/>
Put One Item Before & Two Items After Wednesday
</$button>
{{ListopsData}}Affichera ceci :
DataIndex:
In this example we shall slice the populated list from the 'DaysOfTheWeek' index of the tiddler 'MyData' in order to replace the marker item (Wednesday) with items which are first appended to the list. We shall then move 3 items to the head of the list which have first been appended to the list from referenced fields.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="[[---o]] [[o---]] +[replace:2{!!marker}]"/>
Replace '!!marker' with 2 Items
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="[{!!item1}] [{!!item2}] [{!!item3}] +[putfirst:3[]]"/>
Put 3 Items First
</$button>
{{ListopsData}}Affichera ceci :
DataIndex:
In this example we shall slice the populated list from the 'DaysOfTheWeek' index of the tiddler 'MyData' in order to append to the truncated list, items from a referenced field. We shall then remove the first two of the items added.
|list: |<$view field="list"/> |
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[allbefore:include[Wednesday]] +[prepend{!!list}]"/>
Prepend '!!list' to items before 'Wednesday'
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[remove:2{!!list}]"/>
Remove first two items in '!!list' from current list
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[!remove:1{!!list}]"/>
Remove last item in '!!list' from current list
</$button>
{{ListopsData}}Affichera ceci :
| list: | Yesterday Today Tomorrow |
DataIndex:
In this example we shall populate the list with numbers, then move items one by one from the head to the tail and from the tail to the head (best seen by clicking the lower buttons several times.)
This example illustrates that the append[] and prepend[] operators do not enforce unique instances of an item and that, with the next run, any duplicates are removed.
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $filter="[[]]" $subfilter="+[append:3{!!numbers}]"/>
Setup some numbers
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[!append:6{!!numbers}]"/>
Append more numbers
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[putfirst:2[]]"/>
Move last 2 items to the head
</$button>
<$button>
<$action-listops $tiddler="ListopsData" $index="DataIndex" $subfilter="+[putlast[]]"/>
Move the head to the last item
</$button>
{{ListopsData}}Affichera ceci :
DataIndex:
Histoires épouvantables
Il arrive régulièrement que des utilisateurs de TiddlyWiki nous rapportent des histoires à tordre le cœur concernant des pertes de données personnelles dans les groupes de discussion :
Tout mon TiddlyWiki s'est volatilisé lorsque Firefox a crashé pendant l'enregistrement d'un tiddler.
https://groups.google.com/d/topic/tiddlywiki/oG2L7OXhUoI/discussion
La dernière fois que je l'ai utilisé, c'était hier soir à la maison sur mon ordinateur Windows 7 ; j'ai cliqué sur la coche de validation pour terminer d'éditer ma dernière note, ce qui a déclenché l'enregistrement via TiddlyFox, et j'ai éjecté ma clé USB. Je suis arrivé au bureau ce matin, j'ai branché ma clé USB, entré mon mot de passe TW5, mais il n'a pas voulu s'ouvrir après plusieurs tentatives. J'ai exploré mes répertoires à la recherche de mon fichier html TW5 et j'ai remarqué qu'il ne pesait plus 3Mo, mais 80Ko. Ce qui me conduit à penser que j'ai tout perdu.
https://groups.google.com/d/topic/tiddlywiki/SXStDJ0ntGI/discussion
Arrangez-vous pour que cela ne vous arrive jamais !
La première règle d'utilisation de TiddlyWiki est
Sauvegardez vos données !
TiddlyWiki est un système très souple et personnalisable, qui vous rend responsable de vos données. Un grand soin est porté lors du développement de TiddlyWiki à s'assurer que c'est un lieu sûr pour préserver vos données les plus précieuses, mais au bout du compte, c'est aux utilisateurs que revient la responsabilité de limiter les risques d'une perte de données.
La meilleure façon de s'assurer que vos données sont en sécurité est de mettre en œuvre une procédure de sauvegarde rigoureuse :
- Pensez à utiliser des services du type Dropbox pour sauvegarder continuellement vos données personnelles sur le cloud. (Dropbox dispose d'une fonctionnalité intéressante grâce à laquelle vous pouvez garder la trace des versions précédentes de vos fichiers)
- Faites des sauvegardes avant de passer à une nouvelle version de TiddlyWiki
- Protégez-vous des pires scénarios imaginables : que ce passerait-il si votre clé USB ou votre disque dur tombe en panne. Et si votre ordinateur est attaqué par un virus de la pire espèce ?
- Soyez sur vos gardes et pratiquez la redondance : par exemple, ayez plusieurs exemplaires de vos sauvegardes, et conservez-les dans des endroits physiquement séparés.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
C'est un exemple de tiddler. Voir Macros Table des matières (Exemples).
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.
Examples
Here is an example of the thumbnail-right macro used to create a video thumbnail that floats to the right of the text
<<thumbnail-right link:"Introduction Video" image:"Introduction Video Thumbnail.jpg" caption:"Introduction to ~TiddlyWiki" icon:"{{$:/core/images/video}}" color:"red">>
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.This example tiddler is used to illustrate some of the Filter Operators.
before and after
These examples make use of the Days of the Week tiddler.
[list[Days of the Week]before{!!title}]
[list[Days of the Week]after{!!title}]
Suivant la Philosophie des tiddlers, la documentation des tiddlers est typiquement courte et interconnectée.
Quand un tiddler semble nécessiter des subdivisions, c'est souvent le signe qu'il devrait être fractionné en plusieurs tiddlers. Mais il est raisonnable pour un tiddler de référence de se décomposer en une section d'introduction non titrée, suivie d'une section titrée pour les détails.
La cohérence de la terminologie est essentielle pour éviter la confusion du lecteur. La cohérence de la typographie et de la ponctuation offrent une qualité professionnelle à la documentation. Les macros peuvent participer à l'amélioration de la cohérence du texte et de sa maintenabilité .
Utilisez les listes numérotées pour les instructions pas-à-pas, et les puces pour les listes dont l'ordre est arbitraire. Utilisez une liste de définitions de préférence à une liste à puces si chaque élément de la liste débute par un terme suivi d'une virgule. Autant que possible, évitez de surcharger le lecteur avec une liste hiérarchisée.
Utilisez une table lorsque l'information se divise naturellement en trois colonnes ou plus, ainsi que pour les listes de paramètres, d'attributs, etc., au sein des tiddlers de référence.
La documentation reflète la réalité actuelle de TiddlyWiki. Elle évite les discussions sur ses aspirations.
Plusieurs tiddlers documentaires, particulièrement les référents, sont concernés par un seul concept. Leurs titres doivent correspondre à un groupe nominal succinct comme List Widget ou Champs de Tiddler.
Chacun des mots principaux d'un tel titre commence avec une majuscule. Les mots mineurs comme "et", "ou", "le", "de" and "avec" n'en ont pas.
Les Tags suivent aussi ce modèle.
Les titres de ce genre sont au pluriel s'ils représentent une catégorie d'articles, comme. Raccourcis Clavier ou Champs de Tiddler. Cette forme est utilisée pour étiqueter des tiddlers plus spécifiques dans une catégorie.
Quand un concept est un article plus qu'une catégorie, son tiddler a titre particulier, comme : List Widget, tag Operator.
Commencer un titre avec sa partie la plus distinctive. Par exemple, les tiddlers documents, les opérateurs de filtre ont des titres comme addprefix Operateur. Cela aide le lecteur a parcourir une liste de liens pour trouver un tiddler particulier.
Éviter de commencer un titre avec un article comme "le, la, les" ou "un, une, des".
Par le passé, plusieurs tiddlers avaient des titres CamelCase. C'est progressivement abandonné pour accroître la lisibilité. Les titres CamelCase ne seront plus employés, même pour les tags, exceptés pour les cas comme JavaScript où il existe une orthographe standard.
Les tiddlers d'apprentissage ont souvent des titres long un peu plus élaborés qu'un simple groupe nominal, comme : Dix raisons de passer à TiddlyWiki. Ces titres suivent la règle de la phrase, où seul le premier mot (ainsi que tous noms propres) commence par une majuscule.
Les tiddlers Comment ? ont des titres qui débutent par "Comment ?", de type : Comment éditer un tiddler. Éviter les titres comme :Tiddlers Edition, car un locuteur moyen pourrait ne pas l'interpréter comme le nom d'une catégorie de tiddlers.
Les champs de tiddlers sont les couples nom:valeur qui constituent un tiddler. Les noms de champ peuvent être composés de lettres minuscules non accentuées, chiffres, ou caractères - (tiret), _ (souligné) et . (point).
Les champs standard sont :
| Nom du champ | Référence | Description |
|---|---|---|
title | TitleField | Nom unique du tiddler |
text | TextField | Texte du corps de ce tiddler |
modified | ModifiedField | Date et heure à laquelle le tiddler a été modifié pour la dernière fois |
modifier | ModifierField | Titre du tiddler associé à l'utilisateur qui a modifié ce tiddler pour la dernière fois |
created | CreatedField | Date de création du tiddler |
creator | CreatorField | Nom de l'utilisateur qui a créé le tiddler |
tags | TagsField | Liste des tags associés à un tiddler |
type | TypeField | Type de contenu du tiddler |
list | ListField | Liste ordonnée de titres de tiddlers associée à un tiddler |
Les autres champs utilisés par le noyau sont :
| Nom du champ | Référence | Description |
|---|---|---|
color | ColorField | Couleur CSS associée au tiddler |
description | DescriptionField | Texte de description d'un plugin, ou d'une boîte de dialogue |
draft.of | DraftOfField | Pour les tiddlers en cours d'édition, contient le titre du tiddler initial |
draft.title | DraftTitleField | Pour les tiddlers en cours d'édition, contient le nouveau titre prévu pour le tiddler |
footer | FooterField | Texte de bas de page dans le cas d'un wizard |
library | LibraryField | Avec une valeur à yes, indique qu'un tiddler doit être sauvegardé comme bibliothèque JavaScript |
name | NameField | Dans le cas d'un tiddler provenant d'un plugin, le nom de la personne associée à ce tiddler |
plugin-priority | PluginPriorityField | Dans le cas d'un tiddler provenant d'un plugin, un nombre indiquant la priorité de ce tiddler |
plugin-type | PluginTypeField | Dans le cas d'un tiddler provenant d'un plugin, le type du plugin |
source | SourceField | URL source associée à ce tiddler |
subtitle | SubtitleField | Texte du sous-titre pour un wizard |
Le TiddlyWebAdaptor utilise quelques champs supplémentaires :
| Nom du champ | Référence | Description |
|---|---|---|
bag | BagField | Nom du bagd'où provient le tiddler |
revision | RevisionField | Numéro de révision du tiddler présent sur le serveur |
Voir l'onglet Avancé > Champs du panneau de contrôle pour des détails sur les champs utilisés dans ce wiki.
Les tiddlers peuvent être conservés dans des fichiers texte dans plusieurs formats différents. Les fichiers contenant un seul tiddler peuvent aussi avoir un fichier .meta auxiliaire formaté comme une suite de paires nom:valeur :
title: LeTitreFichiers .tid à la TiddlyWeb
Ces fichiers consistent en une séquence de paires nom:valeur, suivie d'une ligne blanche, puis du texte du tiddler. Par exemple :
title: MonTiddler
Voici le texte de mon tiddler.Notez que de nombreux éditeurs de texte imposent que les fichiers se terminent par un caractère de « nouvelle ligne ». Si vous voulez éviter qu'une ligne soit ajoutée à la fin de votre texte, vous pouvez utiliser cette autre syntaxe :
title: MonTiddler
text: Voici le texte de mon tiddler.Le ContentType application/x-tiddler est utilisé en interne pour ces fichiers
Fichiers <DIV> avec l'extension .tiddler
Les fichiers *.tiddler modernes ressemblent à ça :
<div title="AnotherExampleStyleSheet" modifier="blaine" created="201102111106" modified="201102111310" tags="examples" creator="psd">
<pre>Notez qu'il y a une balise <pre> embarquée, et que les retours à la ligne ne sont pas échappés.
Et bizarrement, aucun codage HTML dans le corps du tiddler.</pre>
</div>Ces fichiers *.tiddler ne sont donc pas vraiment similaires aux tiddlers trouvés à l'intérieur d'un fichier HTML TiddlyWiki, dans lequel le corps du texte est encodé en HTML comme attendu.
Les anciens fichiers *.tiddler étaient plus proches du format de stockage utilisé par TiddlyWiki à l'époque :
<div tiddler="AnotherExampleStyleSheet" modifier="JeremyRuston" modified="200508181432" created="200508181432" tags="examples">Voici un fichier tiddler à l'ancienne, sans balise <pre> embarquée. \nVoyez comme le corps du tiddler est "codé en HTML" et les sauts de ligne échappés par \\n</div>Le ContentType application/x-tiddler-html-div est utilisé en interne pour ces fichiers
Fichiers JSON de type TiddlyWeb
Ces fichiers sont des tableaux de hachages sans fioritures contenant des champs sous la forme name:value. À présent seuls ces champs standards sont traités : title, text, created, creator, modified, modifier, type et tags.
Le ContentType application/json est utilisé en interne pour ces fichiers
Fichiers TiddlyWiki HTML
Les fichiers TiddlyWiki HTML contiennent une collection de tiddlers encodés au format <DIV>.
Pour qu'un fichier HTML soit importable comme un fichier TW non crypté, il faut au minimum qu'il contienne un <div id="storeArea"> juste avant les DIVs des tiddlers, eux-mêmes suivis immédiatement par un </div>. Par exemple :
<div id="storeArea">
<div created="20130302085406905" modified="20130302084548184" tags="Exemples" title="Un titre de tiddler">
<pre>Texte d'un tiddler encodé en HTML
</pre>
</div>
<div created="20140315085406905" modified="20140321084548184" tags="Un Deux [[Trois avec espace]]" title="Un autre titre" champperso="valeur du champ">
<pre>Texte de ce tiddler
</pre>
</div>Les liens sont des éléments d'un tiddler où cliquer engendre la navigation vers un tiddler différent. Le comportement d'une navigation est déterminé par le StoryView (la vue) en cours<<;>> par défaut, la vue classique de TiddlyWiki montre son déroulé comme une suite linéaire de tiddlers.
Presser la touche control ou command en cliquant sur le lien d'un link ouvre le tiddler cible sans s'y déplacer. Cela peut-être un moyen pratique de dresser une suite de tiddlers à lire plus tard.
Les liens sont utiles pour modéliser des relations organiques entre tiddlers, et notamment pour décrire les chemins de navigations entre tiddlers.
Le panneau d'information liste la provenance des liens vers un tiddler dans l'onglet References.
Les filtres peuvent inclure les opérateur de filtrage suivant qui fonctionnent avec les liens<<:>>
[links[]]- renvoie les titres des tiddlers dont les liens proviennent de la sélection des tiddler(s) en cours[backlinks[]]- renvoie les titres des tiddlers destination des liens des tiddler(s) en cours sélectionnés
TiddlyWiki5 modifie l'apparence des liens des tiddlers pour donner plus d'informations sur la cible du lien<<:>>
| Description lien | Affichage lien |
|---|---|
| Vers tiddler existant | Ainsi |
| Vers tiddler inexistant | Ainsi |
| Vers tiddler shadow non remplacé | Ainsi |
| Vers tiddler shadow remplacé par un tiddler ordinaire | Ainsi |
Les liens externes sont affichés comme ceci<<:>> https://tiddlywiki.com/ ou comme ça.
Les tiddlers représentent l'unité d'information fondamentale dans TiddlyWiki. Plus les tiddlers sont petits mieux ils fonctionnent, car il est alors plus facile de les réutiliser en les assemblant de différentes manières.
D'autres systèmes disposent de concepts analogues nommés de façon confusément générique, du style « items », « entrées », « entités » ou « enregistrements ». TiddlyWiki considère qu'il est préférable d'être confusément distinct.
Les tiddlers sont représentés en interne par des listes de valeurs nommées appelées
« champs ». Le seul champ obligatoire est le champ title, mais pour être utiles, les tiddlers comportent aussi un champ text, et tout ou partie des champs standard énumérés dans TiddlerFields.
Introduction
The TiddlerWidget is used to set a value for the current tiddler variable, valid within the scope of the TiddlerWidget.
Content and Attributes
| Attribute | Description |
|---|---|
| tiddler | The title of the tiddler to become the new current tiddler |
CSS Class Variables
The tiddler widget assigns several useful CSS classes to variables that it creates:
- missingTiddlerClass
tc-tiddler-existsor...tc-tiddler-missingdepending on whether the tiddler exists- shadowTiddlerClass
tc-tiddler-shadowif the tiddler is a shadow tiddler- systemTiddlerClass
tc-tiddler-systemif the tiddler is a system tiddler- tiddlerTagClasses
- a space separated list of CSS classes named
tc-tagged-{tagname},
e.g.tc-tagged-introduction
Note: tag names are URI encoded which means that the tag $:/tags/Macro appears as the CSS classtc-tagged-%24%3A%2Ftags%2FMacro. See How to apply custom styles by tag for more details
You can use these variables like this:
<$tiddler tiddler="MyOtherTiddler">
<div class=<<missingTiddlerClass>>>
<$transclude/>
</div>
</$tiddler>See also $:/core/ui/ViewTemplate.
An extension application for Google Chrome that enables TiddlyWiki to save changes directly to the file system.
BuggyJay's TiddlyClip browser extension for Firefox permits clipping of text and graphics from web pages:
http://tiddlyclip.tiddlyspot.com
TiddlyClip allows parts of webpages to be clipped into a TiddlyWiki, and consists of two parts, the browser addon and the TiddlyWiki plugin. The addon is completely memoryless, any configuration is determined by the current TiddlyWiki that the user has select to work with (we say that the addon is docked to the TiddlyWiki). TiddlyClip is designed to work (in a basic mode) without configuration. Once the addon and plugin are installed, all the user has to do is select which TW to dock to.
TiddlyDesktop est une application pour travailler avec les fichiers TiddlyWiki (TiddlyWikiClassic et TiddlyWiki version 5). Il peut être installé sur Windows, Mac OS X or Linux. Il est compatible avec TiddlyWiki version 5 ou l'ancien TiddlyWikiClassic.
Visualisez la vidéo Introduction à TiddlyDesktop
Instructions
- Installer la dernière version de TiddlyDesktop à partir de https://github.com/Jermolene/TiddlyDesktop/releases
- Lancez TiddlyDesktop
- Utilisez le bouton de l'explorateur de fichier pour ouvrir les fichiers TiddlyWiki
- Sauvegardez les modifications de la façon habituelle dans TiddlyWiki
Source
TiddlyDesktop est basé sur le projet OpenSource node-webkit. Les sources sont sur GitHub : https://github.com/Jermolene/TiddlyDesktop/
Voir les Versions de TiddlyDesktop
An add-on for Google Drive that allows TiddlyWiki files stored there to be opened and saved directly
https://chrome.google.com/webstore/detail/tiddly-drive/oaphhjhbbabdjnpjpiliepphpmnioolo
I made an app that lets one edit TiddlyWiki files saved in your Google drive and then saving them back automagically. The page is here https://chrome.google.com/webstore/detail/tiddly-drive/oaphhjhbbabdjnpjpiliepphpmnioolo but I think you need to add it from the Google Drive web interface.
I even added an optional ability to save with ctrl + s hotkeys.
Joshua's launch post
TiddlyFox est une extension pour Firefox qui permet aux fichiers TiddlyWiki autonomes d'enregistrer leurs modifications directement sur le système de fichiers. TiddlyFox fonctionne aussi bien sur les versions station de travail que mobile de Firefox. Voir Enregistrer avec TiddlyFox ou Enregistrer avec TiddlyFox pour Android pour des instructions détaillées.
TiddlyFox peut être téléchargé depuis le site Mozilla Addons :
https://addons.mozilla.org/fr/firefox/addon/tiddlyfox/
Vous pouvez également installer la dernière version de développement de TiddlyFox directement depuis GitHub :
https://github.com/TiddlyWiki/TiddlyFox/raw/master/tiddlyfox.xpi
Summary
On 14th November 2017 Mozilla released Firefox 57, a major new version with many improvements and security enhancements. However, in amongst those improvements are some fundamental changes to Firefox's security model with the unfortunate effect of making it impossible for TiddlyFox to function.
TiddlyFox will remain available for people who continue to use older versions of Firefox, but anyone upgrading to the new version will need to choose a new way to handle saving changes with TiddlyWiki.
Happily, several new ways of working with TiddlyWiki now exist so that users have many alternative choices – see GettingStarted for details. The demise of TiddlyFox has provoked several of these recent developments and thus may well ultimately be good for the community.
There is a discussion thread on the TiddlyWiki forums about these developments.
Background
Firefox was first released in November 2004, a few months after the first version of TiddlyWiki. It was in many ways the Millenium Falcon to Microsoft's Death Star (in the shape of Internet Explorer). IE had by then enjoyed more than 5 years as the dominant browser, leading many in the web community to be frustrated that Microsoft's self-serving extensions to HTML had become de facto standards at the expense of innovation that might benefit the web community as a whole.
Firefox quickly became successful because it managed to render web pages with close enough compatibly with Internet Explorer while offering a superior user experience. A large part of the promise of that user experience was the ability for any user to customise every aspect of the browser. Two innovations were behind this:
- The entire user interface of the browser was constructed in XUL, effectively an extension of HTML that enabled it to render conventional user interfaces (at the time, HTML was largely restricted to simple document-oriented layouts). Tweaking a few lines of XUL code could make wholesale changes to the user interface of the browser
- The Mozilla add-on architecture gave full privileges to add-ons, enabling them to observe and interact deeply with the browser engine itself, and the file system of the computer on which it was running
These two conditions enabled a vibrant ecosystem of Firefox add-ons, many of them extremely popular. In many cases, innovations that were first seen in browser add-ons later became integrated into the browser itself, most notably the web debugger Firebug which was eventually cloned by all the browser manufacturers.
Firefox continued to be extremely popular until Google joined the development of the rival WebKit browser to make Chrome. Google took a very different approach to the trade offs of making a browser, focusing on improving security at the expense of almost all other considerations. They pioneered approaches such as isolating each tab in its own process that were quickly adopted by all other major browsers.
Google's approach precluded them adopting Mozilla's free-for-all approach to add-ons. Instead of having access to the entire browser environment and filing system, add-ons in Chrome see only a restricted subset of what is going on within the browser, and enjoy little or no access to the resources of the host machine.
It was inevitable that Mozilla would eventually adopt Google's approach to browser security vis-a-vis add-ons. There is a point at which it wouldn't be responsible for Mozilla to be releasing a browser that had knowingly worse security than the market leader.
Lessons
Some of the fecundity of the TiddlyWiki ecosystem stems from the adoption of the above two principles from Firefox:
- Making the application user interface out of the same primitives as the application content
- Giving add-ons free rein to observe and interact with all of the internal logic of the application
Those two characteristics present similar security challenges to TiddlyWiki as they did to Firefox. A TiddlyWiki that was primarily focused on security would need to curtail those abilities.
The Future
Innovation on new browser-based user interfaces and capabilities has now shifted from browser extensions to a new generation of frameworks that simplify creation of a custom browser based on an off-the-shelf open source HTML rendering engine. TiddlyDesktop uses nwjs, while Beaker Browser uses an alternative called Electron.
TiddlyIE is an extension for Internet Explorer that allows standalone TiddlyWiki files to save their changes directly to the file system. TiddlyIE works with the desktop version of Internet Explorer.
See Saving with TiddlyIE.
An interactive network visualisation plugin based on Vis.js. A demo that also contains installation instructions can be found here: http://tiddlymap.org. The plugin's GitHub repository can be found here.
TiddlyMap is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable graphs. By creating relations between your topics you can easily do the following:
- Create concept maps and quickly manifest your ideas in tiddlers.
- Create task-dependency graphs to organize and describe your tasks.
- Visualize your topic structures to get an immediate grasp of topics and relations.
In general you may create, visualize and describe any network-structure you have in mind.
An extension to the Node.js configuration of TiddlyWiki that adds support for static attachments and for working with multiple wikis at the same time.
https://github.com/Arlen22/TiddlyServer
TiddlyServer 2.0 takes the server command of TiddlyWiki on NodeJS and adds it to a static file server. This means you can load and serve any TiddlyWiki data folder in the same way you can serve a single file TiddlyWiki.
But you don't need to serve files and folders from just one place, you can serve them from multiple places anywhere on your harddrive (literally anywhere NodeJS can stat, readdir, and readFile). You can even organize them into virtual folders (aka aliases in Apache and mounts in Express).
The main point, of course, is that you can actually edit your files, not just look at them. Single file TiddlyWikis use the put saver, which needs to be patched using a bookmarklet included on the index page. The instructions for this are below under the heading "One thing that needs to be noted".
And, of course, you can edit data folder tiddlywikis just like you were running node tiddlywiki.js data –server, except that you run it on the path that you found it at (e.g. http://localhost/personal/notes/). You can have as many data folders open as you want, they don't conflict (though they will each take memory).
Data folders store individual tiddlers instead of entire wikis. They take less disk space as they also do not store the core and plugins. This means they also save much quicker, especially over the internet. They also save immediately (within 10 seconds or so) and they save drafts.
TiddlySpace was a public TiddlyWiki hosting service that operated from 2010 until 2016.
TiddlySpace, and the underlying TiddlyWeb, was originally sponsored by Osmosoft at BT.
TiddlyWeb is a reference implementation for an interface to put Tiddlers on the web.
It was created by a team led by Chris Dent at Osmosoft under BT from 2008 to 2012.
TiddlyWeb can be used to host TiddlyWiki and TiddlyWiki5 wikis, making the individual tiddlers available over a flexible HTTP API.
Other implementations of the API include:
- TiddlyWiki App Engine Server, a 300-line Go implementation from Russ Cox
- TiddlyWiki 5 server module, the bare-bones subset of the API implemented in TiddlyWiki version 5 for Node.js
As of early 2017, none is currently as complete as TiddlyWeb itself.
The web server API uses tiddlers in a special format originally designed for TiddlyWeb:
- Field values are represented as strings. Lists (like the tags and list fields) use double square brackets to quote values that contain spaces
- Tiddlers are represented as an object containing any of a fixed set of standard fields, with custom fields being relegated to a special property called fields
- The standard fields are: bag, created, creator, modified, modifier, permissions, recipe, revision, tags, text, title, type, uri
For example, consider the following tiddler:
{
"title": "HelloThere",
"tags": "FirstTag [[Second Tag]]",
"my-custom-field": "Field value"
}In transit over the API, the tiddler would be converted to the following format:
{
"title": "HelloThere",
"tags": "FirstTag [[Second Tag]]",
"fields": {
"my-custom-field": "Field value"
}
}TiddlyWiki est un outil riche et interactif, capable de manipuler des données structurées complexes. Il est assez éloigné des outils conventionnels comme les traitements de texte ou les feuilles de calcul.
TiddlyWiki est conçu pour s'adapter à votre cerveau, en vous aidant à gérer ce qui s'adapte mal. L'idée fondamentale est que les informations sont plus utiles et plus facilement réutilisables quand on les découpe en morceaux sémantiques aussi petits que possible – les tiddlers – en leur donnant des titres à partir desquels le wiki pourra se structurer à l'aide de liens, d'étiquettes, de listes et de macros. Les tiddlers utilisent une notation WikiTexte qui permet de représenter de façon concise une grande panoplie de fonctions hypertexte et de formatage. Le but de TiddlyWiki est de fournir une interface de travail fluide, à même de faciliter l'agrégation des tiddlers et leur recomposition en textes plus long.
Les gens adorent utiliser TiddlyWiki. Parce qu'on peut l'utiliser en l'absence d'infrastructure de serveurs compliquée, et parce qu'il est open source, il a apporté une liberté inédite à ceux qui veulent garder le contrôle de leurs précieuses informations. TiddlyWiki a été créé initialement par JeremyRuston et est maintenant devenu un projet open source qui s'épanouit grâce à une communauté active de développeurs indépendants.
The first TiddlyWiki Camp Paris was held on Saturday 6th June 2015.
Bienvenue sur le site du TiddlyWiki Camp. Un évènement pour rencontrer la communauté de ce logiciel Open Source, libre et gratuit. Découvrez ce bloc note personnel polyvalent et adoptez-le pour gérer votre quotidien !
Originally built by Jeremy Ruston and now maintained by Arlen Beiler, TiddlyWiki Cloud (formerly known as TiddlyWiki in the Sky for Dropbox) is an online service that lets you edit TiddlyWiki documents directly in your own Dropbox using just a browser.
It works with TiddlyWiki 5 and Classic.
La communauté TiddlyWiki tient régulièrement salon sur Google Hangouts, en général tous les mardi de 17h à 19h (heure de Paris). Ces rencontres sont annoncées sur le group Google de TiddlyWiki et sur le compte Twitter de TiddlyWiki.
Les échanges précédents sont archivés sur cette playlist YouTube :
TiddlyWiki in the Sky pour TiddlyWeb permet la synchronisation du contenu entre le TiddlyWiki s'exécutant dans un navigateur et un serveur TiddlyWeb (ou TiddlySpace).
Les fonctionnalités incluent :
- Le chargement différé
- Deux modes de synchronisation entre le navigateur et le serveur
- Une synchronisation du serveur par polling (actuellement toutes les 60 secondes)
- Des goulots d'étranglement qui évitent de submerger le serveur avec l'évolution rapide des tiddlers
Pour expérimenter TiddlyWiki in the Sky pour TiddlyWeb :
- Si besoin, créer un compte sur http://tiddlyspace.com/
- Créez un nouvel espace, ex :
<myspace> - Inclure un espace
tw5tiddlyweb - Rendez-vous à
http://<myspace>.tiddlyspace.com/tw5
A catchy jingle for TiddlyWiki.
https://musescore.com/node/796056
Even if it sounds like some ol' jazz tune it IS an original composition and it should be quite obvious that the "hook of the melody" is a trill made by singing Tidd-ly Wiki :-).
My lacking skills for writing text/lyrics should be apparent in the fact that the text consists of 12 Tidd-ly Wikis and some extra "tiddly's" - just for the sake of getting the message delivered ;-)...
I've recorded every instrument on my guitar via a guitar synth on a loop machine (except for the drums - they were played live/in sync with the loop station on a "BeatBuddy" drum pedal..) - no pc was involved..
Ce court screencast montre comment configurer Firefox pour Android afin de pouvoir sauvegarder les modification de TiddlyWiki :
Exécuter TiddlyWiki avec Node.js comporte plusieurs avantages par rapport à la version s'exécutant dans un seul fichier :
- Vous pouvez éditez le contenu du wiki dans n'importe quel navigateur compatible HTML5, y compris s'il tourne sur des smartphones et des tablettes
- Les tiddlers sont stockés dans des fichiers séparés, que vous pouvez organiser comme vous le souhaitez
- Vous avez la possibilté de constuire plusieurs wikis différents à partir de wikis existants dont le contenu peut être combiné avec du contenu qui vous est propre
Pour plus d'informations, voir :
Voici la description des récentes mise à jour de TiddlyWiki5. Voir TiddlyWiki5 Versioning pour plus de détails sur la nomination des versions.
(Les versions Bêta et Alpha sont listées séparément).
Release 5.1.19
Released 20 décembre 2018 at 16:34
See GitHub for detailed change history of this release
This release consists of fixes for bugs discovered in Release 5.1.18.
Hackability Improvements
Bug Fixes
- Fixed incompatible change to the construction of filename used for saving
- Fixed problem with fonts for the KaTeX Plugin
- Fixed problem with forcing basic authentication for the WebServer
- Fixed problem with the ButtonWidget not refreshing when the
popupTitleattribute changes - Fixed problem with
empty.htmlaccidentally containing a splash screen - Fixed regression with search matches across multiple fields
Contributors
@Jermolene would like to thank the contributors to this release who have generously given their time to help improve TiddlyWiki:
An extensive tutorial for getting started with TiddlyWiki. Recommended
https://www.youtube.com/playlist?list=PLzZCajspPU_UjFn0uy-J9URz0LP4zhxRK
This tutorial is aimed at giving you a basic foundation so that you can start using TiddlyWiki right away. Here we take a look at the technology behind Tiddlywiki, how to install it and create your first Tiddler.
Introduction
A tiddlywiki.files JSON file in a sub-folder within a TiddlyWiki folder overrides the usual logic for recursively scanning the folder for tiddler files. Instead, the tiddlywiki.files file specifies instructions for loading tiddlers from specific files and folders.
The format of the file is an object with two optional properties:
- tiddlers - an array of objects describing external files with the ability to override or modify any of the fields read from the file
- directories - an array of objects describing external directories, a filter determining which files within those directories should be processed, and the ability to override or modify any of the fields read from the file
Note that significant enhancements to tiddlywiki.files processing were introduced in Release 5.1.14.
Field overrides
Both the tiddlers and directories sections of tiddlywiki.files files include the ability to override or customise the values of fields with a fields object.
Each field can be specified as either a string or array value to be assigned directly to the field, or New in: 5.1.14 an object describing how to generate the value for the field. The object contains the following properties:
- source - (optional) a string specifying the source value for the field. If not specified, the existing value is used
- filename the filename of the file containing the tiddler
- filename-uri-decoded the filename of the file containing the tiddler, with URI decoding applied
- basename the filename of the file containing the tiddler without any extension
- basename-uri-decoded the filename of the file containing the tiddler without any extension, with URI decoding applied
- extname the extension of the filename of the file containing the tiddler
- created the creation date/time of the file containing the tiddler
- modified the modification date/time of the file containing the tiddler
- prefix - (optional) a string to be prepended to the value of the field
- suffix - (optional) a string to be appended to the value of the field
Tiddlers section
The file specifications in the tiddlers array support the following properties:
- file: (required) the absolute or relative path to the file containing the tiddler data (relative paths are interpreted relative to the path of the
tiddlywiki.filesfile) - isTiddlerFile: (optional) if
true, the file will be treated as a tiddler file and deserialised to extract the tiddlers. Otherwise, the raw content of the file is assigned to thetextfield without any parsing - fields: (optional) an object containing values that override or customise the fields provided in the tiddler file (see above)
- prefix & suffix: (optional) strings to be prefixed and suffixed to the tiddler
textfieldNote that providing a prefix here is equivalent to setting the
textfield of the fields object to{"prefix":"<prefixvalue>"}.
Directories section
Directory specifications in the directories array may take the following forms:
- a string literal, specifying the absolute or relative path to the directory containing the tiddler files (relative paths are interpreted relative to the path of the
tiddlywiki.filesfile). The directory is recursively searched for tiddler files - New in: 5.1.14 an object with the following properties:
- path - (required) the absolute or relative path to the directory containing the tiddler files (relative paths are interpreted relative to the path of the
tiddlywiki.filesfile). Note that the directory is not recursively searched; sub-directories are ignored - filesRegExp - (optional) a regular expression that matches the filenames of the files that should be processed within the directory
- isTiddlerFile - (required) if
true, the file will be treated as a tiddler file and deserialised to extract the tiddlers. Otherwise, the raw content of the file is assigned to thetextfield without any parsing - fields - (required) an object containing values that override or customise the fields provided in the tiddler file (see above)
- path - (required) the absolute or relative path to the directory containing the tiddler files (relative paths are interpreted relative to the path of the
Fields can be overridden for particular files by creating a file with the same name plus the suffix .meta – see TiddlerFiles.
Examples
These example tiddlywiki.files must be placed in their own sub-directory of the wiki folder.
There are also several examples of tiddlywiki.files files in the main TiddlyWiki 5 GitHub repository.
Importing a folder of PDFs
This example retrieves all the files with the extension .pdf from a folder specified by a relative path. Each tiddler is set up for LazyLoading with the following fields:
- title - set to the URI decoded base filename of the PDF file. URI decoding allows characters like "/" to be included in titles by URI encoding them as "%2F"
- created - set to the creation date/time of the PDF file
- modified - set to the modification date/time of the PDF file
- type - set to
application/pdf - tags - set to
$:/tags/AttachedFile - text - set to an empty string
- _canonical_uri - set to the string "pdfs/" concatenated with the filename
{
"directories": [
{
"path": "../../../input/pdfs",
"filesRegExp": "^.*\\.pdf$",
"isTiddlerFile": false,
"fields": {
"title": {"source": "basename-uri-decoded"},
"created": {"source": "created"},
"modified": {"source": "modified"},
"type": "application/pdf",
"tags": ["$:/tags/AttachedFile"],
"text": "",
"_canonical_uri": {"source": "filename", "prefix": "pdfs/"}
}
}
]
}TiddlyWikiFolders are configured with a single tiddlywiki.info file in the root of the wiki folder. It should contain a JSON object comprising the following properties:
- plugins - an array of plugin names to be included in the wiki
- themes - an array of theme names to be included in the wiki
- languages - an array of language names to be included in the wiki
- includeWikis - an array of references to external wiki folders to be included in the wiki
- build - a hashmap of named build targets, each defined by an array of command tokens (see BuildCommand)
- config - an optional hashmap of configuration options (see below)
includeWikis
The entries in the includeWikis array can be either a string specifying the relative path to the wiki, or an object with the following fields:
- path - relative path to wiki folder
- read-only - set true to prevent the tiddlers in the included wiki from being modified. The modifications will be written to the directory specified in default-tiddler-location, described below
build
Note that the build targets of included wikis are merged if a target of that name isn't defined in the current tiddlywiki.info file.
config
Configuration options include:
- default-tiddler-location - a string path to the default location for the filesystem adaptor to save new tiddlers (resolved relative to the wiki folder)
- retain-original-tiddler-path - If true, the server will generate a tiddler $:/config/OriginalTiddlerPaths containing the original file paths of each tiddler in the wiki
Example
For example:
{
"plugins": [
"tiddlywiki/tiddlyweb",
"tiddlywiki/filesystem"
],
"includeWikis": [
{"path": "../tw5.com", "read-only": true}
],
"build": {
"index": [
"--rendertiddler","$:/core/save/all","index.html","text/plain"],
"favicon": [
"--savetiddler","$:/favicon.ico","favicon.ico",
"--savetiddler","$:/green_favicon.ico","static/favicon.ico"]
},
"config": {
"retain-original-tiddler-path": true
}
}Building TiddlyWikiClassic
TiddlyWiki5 can be used to build older 2.x.x versions of TiddlyWikiClassic from their constituent components. Doing so involves these features:
- The
tiddlywiki/classictoolsplugin, containing a deserializer module which allows tiddlers to be loaded from TiddlyWiki 2.x.x.recipefiles - The
stripcommentsformat for the ViewWidget, which strips single line JavaScript comments starting//# - The
stripTitlePrefix='yes'attribute of the FieldsWidget, which removes prefixes wrapped in curly braces from thetitleattribute- For example,
{tiddler}HelloTherewould be transformed toHelloThere
- For example,
Usage
TiddlyWikiClassic is built from the command line by running TiddlyWiki on Node.js. A typical usage would be:
node ../../tiddlywiki.js \
--verbose \
--load <path_to_recipe_file> \
--rendertiddler $:/core/templates/tiddlywiki2.template.html <path_to_write_index_file> text/plain \
|| exit 1TiddlyWiki5 est une réincarnation de TiddlyWiki armée pour les 25 prochaines années. Il s'agit d'une wiki interactif complet, écrit en JavaScript et qui peut s'exécuter soit dans un navigateur web, soit en mode serveur sous Node.js.
Chaque évolution publiée de TiddlyWiki5 est identifiée par un numéro conforme au standard décrit par la Gestion sémantique de Version 2.0.0
TiddlyWiki Version du noyau
Conformément au standard :
Étant donné un numéro de version MAJOR.MINOR.PATCH. Incrémenter le :
MAJOR, quand vos modifications rendent l'API incompatible,
MINOR, quand l'ajout des fonctionnalités respecte la compatibilité,
PATCH, lorsque vos modifications compatibles corrigent des bogues.
Pour les pré-versions et l'ajout de métadonnées, des extensions disponibles peuvent s'ajouter au numéro de version MAJOR.MINOR.PATCH.Versions Alpha et Beta
Quand TiddlyWiki5 était en version alpha, il utilisait l'extension de pre-version "alpha", par exemple :
5.0.1-alphaChaque nouvelle version alpha ou bêta impactera le numéro de version PATCH.
C'est une rupture par rapport au strict respect du standard car l'incrément des PATCH est supposé réservé aux modifications compatibles.
Noter que lors des versions précédant la 5.0.1-alpha, TiddlyWiki5 utilisait des n° de version formulés ainsi 5.0.0-alpha.19. Le changement fut effectué pour permettre au processus de mise à jour d'identifier l'évolution des plugins à partir de l'information donnée par le n° de version.
Versions intermédiaires
En phase de développement, quand une nouvelle version est proposée, l'extension de préversion lui est ajoutée.
Version des Plugin
Numéro de Version
TiddlyWiki5 utilise le n° de version lié aux plugins pour déterminer quel est le plus récent au moment de la phase de mise à jour ou d'import. L'extension pre-release est ignoré quand les comparaisons sont effectuées.
"TiddlyWiki Classic" refers to versions prior to 5.0, before TiddlyWiki was completely rewritten from the ground up. TiddlyWiki Classic is still being maintained at:
Fichiers TiddlyWiki HTML
Les fichiers TiddlyWiki HTML contiennent une collection de tiddlers encodés au format <DIV>.
Pour qu'un fichier HTML soit importable comme un fichier TW non crypté, il faut au minimum qu'il contienne un <div id="storeArea"> juste avant les DIVs des tiddlers, eux-mêmes suivis immédiatement par un </div>. Par exemple :
<div id="storeArea">
<div created="20130302085406905" modified="20130302084548184" tags="Exemples" title="Un titre de tiddler">
<pre>Texte d'un tiddler encodé en HTML
</pre>
</div>
<div created="20140315085406905" modified="20140321084548184" tags="Un Deux [[Trois avec espace]]" title="Un autre titre" champperso="valeur du champ">
<pre>Texte de ce tiddler
</pre>
</div>En plus des wikis contenus dans un seul fichier, TiddlyWiki on Node.js reconnaît les wikis conservés dans un dossier contenant un fichier pour chaque tiddler.
Fichiers et répertoires dans les dossiers TiddlyWiki
Les dossiers TiddlyWiki peuvent contenir les fichiers et répertoires ci-dessous :
- tiddlywiki.info — fichier JSON contenant les métadonnées du wiki
- \tiddlers — répertoire contenant les fichiers de tiddlers constituant le wiki
- \plugins — répertoire contenant les dossiers de plugins à inclure dans le wiki.
Seul le fichier tiddlywiki.info est obligatoire, les dossiers tiddlers et plugins étant optionnels. Les autres fichiers et dossiers éventuellement présents à la racine d'un dossier TiddlyWiki sont ignorés.
Contenu du fichier tiddlywiki.info
Le fichier tiddlywiki.info présent dans un dossier wiki contient un objet JSON contenant les champs suivants :
- plugins - un tableau de noms de plugins à inclure dans le wiki
- themes - un tableau de noms de thèmes à inclure dans le wiki
- languages - un tableau de noms de langues à inclure dans le wiki
- includeWikis - un tableau de chemins relatifs vers des dossiers wikis externes à inclure dans le wiki
- build - une table de hachage de noms de cibles de compilation, chacune étant définie par un tableau de jetons de commande (voir BuildCommand)
- config - une table de hachage optionnelle d'options de configuration (voir ci-dessous)
includeWikis
Les entrées du tableau includeWikis peuvent être soit une chaîne indiquant le chemin relatif vers le wiki à inclure, soit un object contenant les champs suivants :
- path - chemin relatif vers le répertoire du wiki
- read-only - donner une valeur true pour éviter que les tiddlers du wiki inclus soient modifiés. Les modifications seront écrites dans le répertoire spécifié dans l'option de configuration default-tiddler-location, décrite ci-dessous.
build
Notez que les cibles de compilation des wikis à inclure sont fusionnées si aucune cible du même nom n'est définie dans le fichier tiddlywiki.info courant.
config
Les options de configuration comprennent :
- default-tiddler-location — une chaîne de caractères indiquant le chemin vers la localisation par défaut de l'adaptateur système de fichiers utilisé pour enregistrer de nouveaux tiddlers (le chemin est résolu relativement au dossier wiki)
- retain-original-tiddler-path — si la valeur est à
true, le serveur génèrera un tiddler $:/config/OriginalTiddlerPaths contenant les chemins de fichiers d'origine de chaque tiddler dans le wiki.
Par exemple :
{
"plugins": [
"tiddlywiki/tiddlyweb",
"tiddlywiki/filesystem"
],
"includeWikis": [
"../tw5.com"
],
"build": {
"index": [
"--rendertiddler","$:/core/save/all","index.html","text/plain"],
"favicon": [
"--savetiddler","$:/favicon.ico","favicon.ico",
"--savetiddler","$:/green_favicon.ico","static/favicon.ico"]
},
"config": {
"retain-original-tiddler-path": true
}
}Contenu du dossier tiddlers
Tous les fichiers de tiddler présents dans le dossier tiddlers et ses sous-dossiers sont interprétés dans le wiki au démarrage. Les éventuels sous-dossiers sont explorés récursivement.
Les sous-dossiers contenus dans le dossier tiddlers peuvent également contenir un fichier JSON nommé tiddlywiki.files qui modifiera le traitement par défaut de ce dossier. Le format de ce fichier est illustré par cet exemple tiré du plugin D3 :
{
"tiddlers": [
{
"file": "d3.min.js",
"fields": {
"type": "application/javascript",
"title": "$:/plugins/tiddlywiki/d3/d3.js",
"module-type": "library"
},
"prefix": "var d3;if($tw.browser){\n",
"suffix": "}\nexports.d3 = d3;\n"
},
{
"file": "cloud/d3.layout.cloud.js",
"fields": {
"type": "application/javascript",
"title": "$:/plugins/tiddlywiki/d3/d3.layout.cloud.js",
"module-type": "library"
}
}
]
}Les données JSON consistent en un objet ayant une propriété tiddlers qui contient un tableau d'informations sur chaque tiddler à charger dans le wiki. Cette information est constituée de :
file: le chemin de fichier relatif ou absolu du fichier de tiddler à inclurefields: un objet contenant des champs qui surchargent ceux éventuellement fournis dans le fichier de tiddlerprefix&suffix(optionnels) : chaînes de caractères à utiliser pour préfixer et suffixer le contenu texte du fichier de tiddler.
The timeline macro returns a list of tiddlers in reverse chronological order of modification (or some other date field), grouped by day.
Parameters
- limit
- The maximum number of tiddlers to include, defaulting to 100. But if any tiddlers are included for a particular day, all of the other tiddlers for that day will also be included – even if this exceeds the limit
- format
- A string specifying the desired format, defaulting to
DDth MMM YYYY - subfilter
- An optional extra filter step, e.g.
tag[MyTag] - dateField
- The name of the date field to use, defaulting to
modified
The tiddlers are selected by means of a filter expression, into which the subfilter and limit parameters are spliced as follows:
[!is[system]$subfilter$has[$dateField$]!sort[$dateField$]limit[$limit$]eachday[$dateField$]]
<<timeline format:"DD/MM/YYYY">><<timeline limit:30 subfilter:"tag[Definitions]" format:"DD/MM/YYYY">>The Tinka plugin provides the ability to create and modify plugins in the browser, without requiring the use of Node.js.
See https://github.com/TinkaPlugin/Tinka for the GitHub repo.
https://tinkaplugin.github.io/
This is a Control Panel extension that aims to simplify the plugin creation and editing process. After installing, you will find a new tab in your control panel that makes creating and modifying plugins a little bit easier.
Le tiret est un signe de ponctuation. Il ne doit pas être confondu avec le trait d’union et le signe moins. Il existe trois types de tirets, en fonction de leur longueur : le tiret court, le tiret moyen et le tiret long.
Wikipedia : http://fr.wikipedia.org/wiki/Tiret
| Caractère | CP1252 | Code HTML | Noms | Usages |
| - | Alt 45 | - | trait d'union-signe moins (celui du clavier) | trait d'union, signe moins |
| ‐ | ‐ | trait d'union, tiret court, tiret quart de cadratin | trait d'union | |
| − | − | signe moins | signe moins | |
| – | Alt 0150 | – | tiret moyen, tiret demi-cadratin | tiret d'incise, tiret d'énumération, tiret de liste |
| — | Alt 0151 | — | tiret long, tiret cadratin | tiret de dialogue |
Illustration : − – + (signe moins, tiret moyen et signe plus)
Voir aussi l'Atelier typographique : http://monsu.desiderio.free.fr/atelier/tiret.html
Une liste de titre est une liste de texte contenant un ou plusieurs titres de tiddlers, reliés par un espace entre chacun d'eux et le suivant.
Si un de ses titres contient un espace, il devra être entouré de double crochets :
PourDémarrer [[Découvrir TiddlyWiki]] Communauté
Les listes de titres sont utilisées en des endroits variés, dont les PermaLiens et les Champs list.
Elles sont en fait la plus simple expression d'un filtre, et donc un moyen d'exprimer une sélection de titres.
| purpose | select a single title |
|---|---|
| input | ignored |
! input | a selection of titles |
| parameter | T = a tiddler title |
| output | a selection containing only T |
! output | the input, but with tiddler T filtered out if it exists in the wiki |
[title[An Example]] can be shortened to [[An Example]], because title is the default filter operator.
title is a constructor (except in the form !title), but field:title is a modifier.
[title[HelloThere]]
[[HelloThere]]
HelloThere
[title[HelloThere]] [title[Filter Operators]]
[[HelloThere]] [[Filter Operators]]
HelloThere [[Filter Operators]]
[tag[Filters]] +[!title[Filter Operators]]
[tag[Filters]] +[![Filter Operators]]
[tag[Filters]] -[[Filter Operators]]
Une sélection de titre est une suite ordonnée de titres de tiddlers (ou chaines similaires), dans laquelle aucun titre n'apparait plus d'une fois.
Les sélections de titres sont importantes dans les processus de filtre.
La façon la plus simple d'en écrire une est une liste de titres.
Introduction
Le TranscludeWidget importe dynamiquement le contenu d'un autre tiddler.
Attributs
| Attribut | Description |
|---|---|
| tiddler | Le titre du tiddler à transclure (par défaut le tiddler courant) |
| field | Le nom du champ du tiddler courant (par défaut "text" ; si présent, a priorité sur l'attribut index) |
| index | L'index d'une propriété d'un Data Tiddler |
| subtiddler | Titre optionnel d'un SubTiddler quand le tiddler cible est un plugin (voir infra) |
| mode | change le mode d'analyse par défaut du texte transclu à "block" ou à "inline" |
Le TranscludeWidget traite tout contenu avec les solutions par défaut si la cible de transclusion n'est pas complètement définie (ex : un tiddler ou un champ manquant)
Modes d'analyse
TiddlyWiki analyse le texte par deux modes :
- le mode inline reconnaît les formats de caractères comme l'emphase, les liens
- le mode bloc reconnaît tous les formats inline, et le complète des formats bloc comme les tableaux, les listes et les rubriques
Habituellement, le mode, bloc ou en ligne, est déterminé automatiquement par le widget transclude lui-même au moment de l'analyse. Ceci peut être ajusté par l'attribut mode.
Par exemple, considérons un tiddler "A" avec ce contenu :
# Article un
#<$transclude tiddler="B"/>
# Article deuxEt un tiddler "B" avec ce contenu :
# Article un - a
# Article un - bLe résultat donnera quelque chose comme :
- Article un
- # Article un - a # Article un - b
- Article deux
Cela peut être corrigé en modifiant le tiddler "A" :
# Article un
#<$transclude tiddler="B" mode="block"/>
# Article deuxAccès au SubTiddler
Le transclude widget permet l'accès aux tiddlers individuels mémorisés dans un plugin.
L'exemple suivant transclura la version initiale d'un tiddler noyau $:/DefaultTiddlers même si il a été modifié :
La Transclusion est le procédé de référencement d'un tiddler "A" à partir d'un autre tiddler "B" de sorte que le contenu de "A" apparait être une partie de "B".
Copier / coller du contenu crée des copies multiples d'un même contenu en différents endroits. Avec la transclusion, il peut y avoir une seule copie et une instruction spéciale dans "B" qui mentionne le point à partir duquel doit être inséré le contenu du tiddler "A".
Notez que si le contenu de "A" est modifié, alors la modification apparait immédiatement dans "B". Cela rend aisé la maintenance de contenu répétitif, en permettant l'écriture d'éléments à un seul endroit, mais l'affichage en de multiple lieux.
Le concept de transclusion joue un rôle important dans la Philosophie des Tiddlers car c'est la première façon de combiner le contenu de petits articles.
En savoir plus :
The power of WikiText comes from the ability to use the content of one tiddler inside another one. This ability takes several different forms that can easily be confused.
The main distinction is between a transclusion and a textual substitution:
- A transclusion is replaced dynamically with the value of either:
- a tiddler field
- a variable
- Textual substitutions are performed on the text of macro definitions before they are used
Tiddler Field Transclusion
Transclusion in WikiText describes the basics of transclusion. For example:
{{MyTiddler}}As described in HTML in WikiText, you can also transclude tiddler field values as attributes of HTML elements and widgets. For example:
<$text text={{MyTiddler}}/>As described in Introduction to filter notation, you can also transclude tiddler field values as filter operands. For example:
{{{ [tag{TiddlerContainingMyTag}] }}}Variable/Macro Transclusion
Variables that were defined with parameter or variable substitution are referred to as "macros". The value of a variable/macro can be transcluded with the syntax:
<<myMacro param:"Value of parameter">>As described in HTML in WikiText, you can also transclude a variable as the value of an attribute of HTML elements and widgets. For example:
<$text text=<<myMacro>>/>As described in Introduction to filter notation, you can also transclude a variable as the value of a filter operand. For example:
{{{ [tag<myMacro>] }}}Textual Substitution
Textual substitution occurs when the value of a macro/variable is used. It is described in Macros in WikiText.
The key difference between substitution and transclusion is that substitution occurs before WikiText parsing. This means that you can use substitution to build WikiText constructions. Transclusions are processed independently, and cannot be combined with adjacent text to define WikiText constructions.
Transclusion Simple
Pour inclure le contenu d'un TiddlerA dans un TiddlerB, modifier le précédent pour y inclure le texte suivant :
Voici le contenu de TiddlerA: {{TiddlerA}}Le résultat permet au contenu du champ text (c.à.d le contenu principal) du TiddlerA de s'afficher dans le TiddlerB.
Utilisation
La notation {{TiddlerA}} est une abréviation de {{TiddlerA!!text}}, puisque le champ de transclusion par défaut est text, mais tout autre champ peut être spécifié. Par exemple, vous pouvez visualiser la dernière fois que le TiddlerA fut modifié par :
TiddlerA a été modifié le {{TiddlerA!!modified}}En omettant le titre du tiddler, la notation de transclusion peut aussi être utilisé pour afficher le contenu d'un champ du tiddler en cours, par exemple :
Le tiddler en cours a été modifié le {{!!modified}}Erreurs Récursives
Notez que l'utilisation de {{!!text}} ou {{}} engendre le message d'erreur (Erreur dans le widget transclude : transclusion récursive), car il n'y a aucun sens à inclure le contenu du tiddler courant dans le contenu du tiddler courant (c.à.d, en lui-même). Chaque fois que vous rencontrez ce message d'erreur, cela voudra dire que vous essayez d'inclure quelque chose en lui-même, directement ou indirectement (par exemple si le tiddler A transclut le tiddler B qui transclut le tiddler C qui, à son tour, transclut le tiddler A).
En savoir plus
Dans TiddlyWiki, les transclusions ne sont pas limitées à l'inclusion de contenu brut comme ci-dessus. Pour en apprendre plus au sujet de modes d'utilisation plus poussées, voir Transclusion par Gabarits.
Voir aussi :
Introduction
Vous pouvez insérer le contenu d'un tiddler dans un autre en utilisant les marques de transclusion :
{{MonTiddler}}transclut un seul tiddler{{MonTiddler||TitreDuGabarit}}affiche un tiddler via un format spécifié par un Gabarit de Tiddler{{||TitreDuGabarit}}affiche le Tiddler en cours par le gabarit spécifié sans l'altérer
Transclure les Références de Texte
Vous pouvez aussi utiliser une Référence de Texte à la place du titre d'un tiddler :
{{MonTiddler!!champ}}transclut un champ spécifique d'un tiddler quelconque{{!!champ}}transclut le champ spécifique du tiddler courant{{MonTiddler##index}}transclut une propriété indexée spécifique d'un Tiddler Data{{##index}}transclut une propriété indéxée spécifique du Tiddler Data courant
Transclusion Filtrées
Une syntaxe similaire peut être mise en œuvre pour transclure une liste de tiddler selon des critères particuliers définis par un Filtre :
{{{ [tag[mécanisme]] }}}
{{{ [tag[mécanisme]] ||TitreDuGabarit}}}Widgets Générés
La syntaxe de transclusion de WikiTexte génère un TiddlerWidget enveloppé dans un TranscludeWidget. Par exemple, {{MonTiddler||MonGabarit!!monChamp}} génère cette paire de widgets:
<$tiddler tiddler="MonTiddler">
<$transclude tiddler="MonGabarit" field="monChamp"/>
</$tiddler>Voir Aussi :
The transclusion variable is set by the $transclude widget to a string that identifies the position of that widget within the widget tree.
TiddlyWiki's core uses it to detect recursive transclusion. It is also used to implement the qualify macro.
The string has the following syntax:
- the title of the current tiddler
- the title of the tiddler being transcluded
- the name of the field being transcluded
- the name of the property name or index being transcluded
- the name of the subtiddler being transcluded from a plugin
Many of the five items are often blank.
In the sidebar, the value of transclusion is:
{|$:/core/ui/PageTemplate/sidebar|||}
When the tiddler HelloThere is displayed in the story river, transclusion is set to:
{HelloThere|HelloThere|||}
This example shows how to distinguish between the sidebar and other environments:
We are
<$list
filter="[<transclusion>prefix[{|$:/core/ui/PageTemplate/sidebar|||}]]"
emptyMessage="in the story river.">
in the sidebar.
</$list>In the sidebar, this would show We are in the sidebar instead.
Introduction
Dans Transclusion, utilisation basique nous avons découvert comment inclure le contenu d'un tiddler A dans un tiddler B. Alors, supposons que le tiddler A contienne :
@@background-color:yellow;
Salut, mon titre est {{!!title}}
@@Ceci fait afficher au tiddler A son titre sur fond jaune (voir Les styles et les classes avec WikiText pour les styles CSS). Imaginez que vous vouliez afficher le titre du tiddler B de la même façon. Mais que vous ne souhaitiez pas copier/coller les instructions de style, car vous désirez changer la couleur du fond plus tard et que vous vioulez maintenir une cohérence entre les tiddlers. Cela ressemble à un cas typique de transclusion, aussi essayons de transclure le tiddler A en tiddler B par la voie classique par {{A}}. Vous verriez alors le contenu suivant dans le tiddler B :
Salut, mon fr-titre est Transclusion par gabarits
Le stype est appliqué comme attendu, mais le titre est faux : nous voulons que {{!!title}} se réfère au tiddler B, cible, et pas au tiddler A, source.
La solution est dans l'utilisation d'un gabarit. Dans ce cas, le tiddler A, source, est appelé le Tiddler Gabarit, et est appliqué au tiddler B par l'utilisation de la notation {{||A}}. La différence est que toute Référence texte qui ne se réfère pas explicitement à un tiddler spécifique est affectée au tiddler courant, qui est, le tiddler cible. En conséquence, le tiddler B a maintenant l'aspect attendu :
Salut, mon titre est B
Utilisation
La Transclusion par gabarit est comparable à un masque : en supposant que le tiddler source contienne les références génériques (comme les trous des yeux dans un masque), celles-ci seront remplacées par les valeurs des tiddlers cible (comme les yeux d'une personne qui porte le masque).
Un gabarit peut être appliqué à tout tiddler, pas seulement au tiddler en cours, en utilisant la notation complète {{<cible>||<gabarit>}}. La <cible> par défaut est le tiddler courant (qui a été utilisé dans l'exemple supra).
Exemples
Un gabarit prédéfini pour un bel affichage des tags
Vous pouvez appliquer le gabarit système $:/core/ui/TagTemplate à un tag pour lui donner le style d'une pilule avec menu déroulant :
{{Transclusion||$:/core/ui/TagTemplate}}a pour rendu :
Voir aussi :
There is a special edition of TiddlyWiki that simplifies creating and maintaining translations:
- https://tiddlywiki.com/editions/translators/ to translate current version of TiddlyWiki
- https://tiddlywiki.com/prerelease/editions/translators/ to translate latest prerelease version of TiddlyWiki
Note that no knowledge of Node.js or GitHub is required.
You can translate TiddlyWiki on Node.js, type tiddlywiki editions/translators --listen and visit http://127.0.0.1:8080/ in your browser.
See https://tiddlywiki.com/dev for technical details of creating and maintaining translations.
The translation mechanism of TiddlyWiki manages and switches between language plugins that provide translations of the TiddlyWiki user interface. The developer site at https://tiddlywiki.com/dev/ explains how translators can create and submit translations for TiddlyWiki.
The title of the current language plugin is read from the tiddler $:/language. If the selected plugin changes then any displayed translateable text automatically changes.
Translation plugins are bundles of tiddlers that each contain an indepedent translatable string. The strings are transcluded as needed.
Translatable strings are generally in the namespace $:/language/, for example:
A personal website built with TiddlyWiki.
TriTarget.org is a name I came up with in high school. I was big into computer programming and wanted a company name that was kinda catchy. When I made a few programs in BASIC I would brand them with TriTarget as a way to show off my company (Even though I didn't have one).
Voici quelques pages web contenant des astuces et des tutoriels liés à TiddlyWiki :
"Un wiki sur votre BiblioBox avec TiddlyWiki" from A Penguin in Redmond
http://bibliobox.net/blog/post/2014/07/16/un-wiki-sur-votre-bibliobox-avec-tiddlywiki
Posted il y a 3 ans
Un manuel d'utilisation de TiddlyWiki (en Français) sur BiblioBox, une des variations de la PirateBox, système mobile de transfert et partage de fichiers.
http://bibliobox.net/blog/post/2014/07/16/un-wiki-sur-votre-bibliobox-avec-tiddlywiki
J'ai connu TiddlyWiki à ses débuts en 2004. Je l'utilisais régulièrement comme bloc-notes de façon personnelle ou professionnelle en 2007 et 2012. Mais j'admets avoir ignoré cet outil pendant les deux dernières années. Et voilà que je me suis dit hier : mais pourquoi ne pas mettre TiddlyWiki sur une BiblioBox ? puisque c'est un simple fichier HTML avec du javascript. De plus je connaissais l'existence d'une version serveur pour sauvegarder les modifications en ligne.
"Microblogging con Tiddlywiki" by Juan
http://3palmeras.wordpress.com/2014/11/05/microblogging-con-tiddlywiki/
Posted il y a 4 ans
A Spanish guide to using TiddlyWiki on Android.
http://3palmeras.wordpress.com/2014/11/05/microblogging-con-tiddlywiki/
Tiddlywiki software is prodigious based on javascript which is capable of holding a notepad that can be edited with Internet Explorer or function as a full blog, contained in a single file.
Translation by Google Translate
"TW5 Magick" by Stephan Hradek
http://tw5magick.tiddlyspot.com/
Posted il y a 4 ans
Stephan Hradek's growing catalogue of tips, tutorials, and other resources. Stephan has also developed several plugins and macros that you can find at http://tiddlystuff.tiddlyspot.com/.
http://tw5magick.tiddlyspot.com/
Some things in TiddlyWiki seem like Magic. As my preferred nick is Skeeve, I felt that TW5 Magick is a proper name for this collection of some of the "magic" tricks one can do with TiddlyWiki.
"TW5 Tribal Knowledge" from Scott Kingery
http://techlifeweb.com/tw5tribalknowledge.html
Posted il y a 4 ans
Tips and guides for using TiddlyWiki.
http://techlifeweb.com/tw5tribalknowledge.html
I never used Node.js until a couple weeks ago when I wanted to try a TW5 installation on Node and expand my knowledge a bit. I figured someone else may be in the same boat so I wrote it all down
"Install and run TiddlyWiki on a CentOS 6 VPS using Nginx" from RoseHosting
http://www.rosehosting.com/blog/install-and-run-tiddlywiki-on-a-centoos-6-vps-using-nginx/
Posted il y a 4 ans
A step by step guide to running TiddlyWiki on a CentOS Virtual Private Server.
http://www.rosehosting.com/blog/install-and-run-tiddlywiki-on-a-centoos-6-vps-using-nginx/
In this tutorial we will guide you through the steps of installing and running TiddlyWiki on a CentOS 6 VPS.
We will also install and configure Nginx as a reverse proxy, so you can run TiddlyWiki behind Nginx.
"Creating a baby journal with TiddlyWiki 5" from A Penguin in Redmond
http://a-penguin-in-redmond.blogspot.co.uk/2014/02/creating-baby-journal-with-tiddlywiki-5.html
Posted il y a 4 ans
A guide to creating a baby journal with TiddlyWiki.
http://a-penguin-in-redmond.blogspot.co.uk/2014/02/creating-baby-journal-with-tiddlywiki-5.html
Keeping a journal about your baby is fun. It allows you to keep track of those events in your baby's life and development that are most important to you, and to tell them in your own words. [...]
There are plenty of online services that can help to keep such a diary, but you need to have an internet connection to access them, and you have to trust them to keep your data safe.
"デザイン刷新。次の25年を目指すTiddlyWiki" by Moongift
http://www.moongift.jp/2013/11/tiddlywiki5-%E3%83%87%E3%82%B6%E3%82%A4%E3%83%B3%E5%88%B7%E6%96%B0%E3%80%82%E6%AC%A1%E3%81%AE25%E5%B9%B4%E3%82%92%E7%9B%AE%E6%8C%87%E3%81%99tiddlywiki-2/
Posted il y a 5 ans
An introduction to TiddlyWiki in Japanese.
"Shining Ark Using TiddlyWiki" by Helu
http://helugame.wordpress.com/2013/09/07/shining-ark-7-using-tiddlywiki/
Posted il y a 5 ans
A gamers guide to using TiddlyWiki.
http://helugame.wordpress.com/2013/09/07/shining-ark-7-using-tiddlywiki/
I’ve been using TiddlyWiki for this game mainly to record the monsters’ locations and the items that they drop. This is so that when I need a certain item to upgrade/create weapons, I can quickly look it up; which monsters drop it and which quests have those monsters.
As I play the game, as I encounter new information, I just input them into my Shining Ark TiddlyWiki. It’s like I’m building a wiki from scratch. The reason why I don’t just use online wikis is that 1) it’s too easy to get spoiled and 2) sometimes online wikis provide too much information (who cares about the non-gameplay related descriptions that can be found in the game, etc).
The tv-adjust-heading-level variable allows the level of headings to be adjusted. It is interpreted as a positive or negative number (e.g. "2" or "-3") that is added to the heading level for display.
Note that if the resulting heading level is less than 1 then level 1 is used instead. This means that specfiying a large negative adjustment factor will reset all headings to display as level 1. Similarly, heading levels larger than 6 are clamped to the maximum HTML heading level of 6.
Tiddlers
Sample Headings 1,2,3
! This is a Level 1 Heading
This is a paragraph.
<$vars tv-adjust-heading-level="-2">
{{Sample Headings 3,4,5}}
</$vars>
!! This is a Level 2 heading
<$vars tv-adjust-heading-level="-1">
{{Sample Headings 4,5,6}}
</$vars>
Sample Headings 3,4,5
!!! This is written as a Level 3 heading
!!!! This is written as a Level 4 heading
!!!!! This is written as a Level 5 heading
Sample Headings 4,5,6
!!!! This is written as a Level 4 heading
!!!!! This is written as a Level 5 heading
!!!!!! This is written as a Level 6 heading
Example
<$transclude tiddler="Sample Headings 1,2,3" mode="block"/>The tv-auto-open-on-import variable controls whether the tm-import-tiddlers message causes the tiddler $:/Import (which lists the pending imports) to open in the story river.
By default, the tiddler is opened. But if this variable has the value no, it isn't.
An example of setting this variable to no can be found in the upgrade plugin within the TiddlyWiki Upgrade Wizard. People can drag their wiki files onto the wizard without triggering the normal import display.
The tv-config-toolbar-icons variable controls whether toolbar buttons display icons.
It can be set to yes or no prior to transcluding such a button.
The standard page template sets it to the value found in $:/config/Toolbar/Icons, with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the Paramétrage tab of the Control Panel.
See also tv-config-toolbar-text.
The tv-config-toolbar-text variable controls whether toolbar buttons display text.
It can be set to yes or no prior to transcluding such a button.
The standard page template sets it to the value found in $:/config/Toolbar/Text, with the result that this becomes the default for the whole page. The user can adjust this default by using a tickbox on the Paramétrage tab of the Control Panel.
See also tv-config-toolbar-icons.
New in: 5.1.15 The tv-filter-export-link variable controls the value of the href attribute on the HTML a element generated by the $link widget. If defined, it takes precedence over the tv-wikilink-template Variable.
The variable is treated as a filter that is given the target tiddler title as input. The filter is evaluated and the first result is used as the href attribute.
For example:
\define tv-filter-export-link() [encodeuricomponent[]encodeuricomponent[]addsuffix[.html]]See also the tv-get-export-link variable, which dominates over this one.
The tv-get-export-image-link variable controls the value of the src attribute on the HTML img element generated by the $image widget when the value of its source attribute is not the title of a tiddler.
The variable should be a macro with the following parameter:
- src
- The value of the
sourceattribute – equivalent to the image name specified in the shorthand syntax[img[source]]
The ability to override image URIs in this way can be useful when one is using the Node.js configuration to export a static version of a wiki.
This example fetches the TiddlyWiki icon:
\define tv-get-export-image-link(src) https://www.tiddlywiki.com/$src$
[img[favicon.ico]]The tv-get-export-link variable controls the value of the href attribute on the HTML a element generated by the $link widget.
The variable should be a macro with the following parameter:
- to
- The title of the target tiddler of the link, with no escaping
See also tv-wikilink-template. If both that variable and this one exist, this one dominates.
The tv-get-export-path variable specifies the full pathname to which the rendertiddlers Node.js command writes each tiddler.
The variable should be implemented as a JavaScript macro with the following parameter:
- title
- The title of the tiddler
If no such macro exists, the tiddlers are written to files whose names are percent-encoded, in the command's output folder.
The tv-history-list variable is assigned by the NavigatorWidget to contain the title of the tiddler containing the current history list.
Compare tv-story-list.
The tv-show-missing-links variable defines if missing links within the scope of the variable are rendered as links or not.
Globally, the variable is set within the PageTemplate and can be changed in the $:/ControlPanel under Settings - Show missing links to tiddlers
If tv-show-missing-links is set to no, missing links are rendered as plain text
If tv-show-missing-links is set to yes, missing links are rendered as wiki-links
The tv-story-list variable is assigned by the NavigatorWidget to contain the title of the tiddler containing the current story list.
Compare tv-history-list.
The tv-tiddler-preview variable indicates whether content is being rendered in a tiddler preview panel.
The value is yes within the preview panel, and undefined elsewhere.
The tv-wikilink-template variable controls the value of the href attribute on the HTML a element generated by the $link widget. The tv-filter-export-link, if defined, it takes precedence over the tv-wikilink-template variable.
The variable is treated as if it was a macro with the following parameters:
- uri_encoded
- The title of the target tiddler of the link, but percent-encoded
- uri_doubleencoded
- The value of the
uri_encodedparameter but percent-encoded again, i.e. with its%characters further converted to%25
\define tv-wikilink-template() ../tiddlers/$uri_encoded$.html
The variable defaults to #$uri_encoded$.
See also the tv-get-export-link variable, which dominates over this one.
This example shows a way of giving links a tooltip derived from the target tiddler's caption field:
\define tv-wikilink-tooltip()
<$transclude field="tooltip">(<$transclude field="caption"/>)</$transclude>
\end
Here is a link to [[backlinks Operator]] with a custom tooltip.Here is a standard link for comparison.
The tv-wikilinks variable controls the behaviour of the $link widget.
The widget normally produces a link to a tiddler. But if this variable has the value no, the widget suppresses the link and simply displays the text that would otherwise have served as the link.
You can suppress links for a whole tiddler by placing the following line at the start of the tiddler's text:
\define tv-wikilinks() no
This variable has no effect on external links, as those do not involve the $link widget.
HelloThere,
[[HelloThere]],
<$link to="HelloThere">is //this// a link?</$link><$set name="tv-wikilinks" value="no">
HelloThere,
[[HelloThere]],
<$link to="HelloThere">is //this// a link?</$link>
</$set>Ce plugin, pour l'instant expérimental, permet d'afficher le WIkiText écrit pour la version classique originelle de TiddlyWiki.
TiddlyWiki5 Packaged with the multi-user plugin in a single executable file.
https://github.com/OokTech/TW5-SingleExecutable
Tiddlywiki, node js, multiuser plugin - all packaged into a single file so user can just download the file and run it and not have to install anything else. Versions available for windows, osx, and linux.
A collection of hints and tips, musings and proposals from long-time TiddlyWiki contributor Mat Goldman.
http://twaddle.tiddlyspot.com/
This is Mat's, a.k.a <:-) little man-cave in the TiddlyVerse.
Most TW development is, understandably, based on the premise that "Improve code ➔ Better TW". TWaddle is also about developing TW but from the perspective that Bigger community ⇄ Better TW. Thus, TWaddle looks more to people issues - how to attract them, how to make them stick with TW etc.
I'm not a programmer but I am a TW enthusiast so I tiddlefiddle enough to make the occasional discovery of something cool. Given the amount of words I utter, it is also a mere numbers game before I say something that makes sense. TWaddle is intended to capture these eventualities.
The CommunitySearch wiki aggregates many public wikis from the community. It is updated automatically every day. At the time of writing, more than 5000 tiddlers are indexed, thus giving access to the largest known collection of TW content.
It lets you search for some specific content among a preselected list of wikis. The indexed content is mostly focused on TW usage, so you would typically use this search system to find information about a particular aspect of TiddlyWiki. Say for example that you want to learn how to make a table of content, type "table of content" in the CommunitySearch box (also accessible in the default tiddler GettingStarted). The search results are links to various wikis, and point directly to the specific tiddlers containing your request.
The CommunitySearch wiki also lets you:
- Browse the list of wikis
- Browse the list of author
- Browse the list of plugins
- Access content by tag (see also BookmarkingTags)
- Follow the latest news from the community (and publish your own news if you are a wiki author)
This plugin adds a <$twitter> widget that can embed a variety of entities from twitter.com:
- Individual tweets and conversation threads
- Buttons to tweet a hashtag/account, follow/like an account, or share a URL
- Timelines showing tweets from a user, hashtag, list or collection
An authentication proxy for your TiddlyWiki.
https://github.com/stevenleeg/twproxy
One of my favorite aspects of TiddlyWiki has been that it's web-based, making it possible for me to access my wiki from everywhere (especially my phone). That being said, I'm a bit paranoid, so I was left a bit unsatisfied with the tiddlywiki server's HTTP basic auth for protecting my wiki. ~23 commits later, I've created something called twproxy that I'd like to share with you all today, as I'm hoping somebody other than myself will find it useful.
Essentially it is a simple proxy that puts your wiki behind a username, password, and optional 2-factor auth prompt. This gives you added security in addition to the ability to remember your credentials past one browsing session (I was getting sick and tired of typing my username/password in over and over using basic auth).
WikiText peut inclure des blocs de textes qui seront renvoyés avec un contenu lié à leur ContentType, comme cela :
$$$image/svg+xml
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100">
<circle cx="100" cy="50" r="40" stroke="black" stroke-width="2" fill="green" />
</svg>
$$$Ce qui affichera ::
Il est aussi possible d'abréger la déclaration du ContentType par son extension. Exemple :
$$$.svg
<svg xmlns="http://www.w3.org/2000/svg" width="150" height="100">
<circle cx="100" cy="50" r="40" stroke="black" stroke-width="2" fill="red" />
</svg>
$$$Ce qui affichera :
Les types inconnus s'afficheront comme du texte brut :
$$$text/unknown
Du texte brut, qui ne sera pas //mis en forme//.
$$$Ce qui affichera :
Du texte brut, qui ne sera pas //mis en forme//.Un rendu spécifique peut-être indiqué, déterminant l'affichage d'un rendu de texte particulier. Par exemple :
$$$text/vnd.tiddlywiki>text/html
Ceci est un ''peu'' de wikitext
$$$
$$$text/vnd.tiddlywiki>text/plain
Ceci est un ''peu'' de wikitext
$$$Afficheront respectivement :
<p>Ceci est un <strong>peu</strong> de wikitext</p>
Ceci est un peu de wikitext
Use the documentation macros to keep the text maintainable in the face of change.
Be wary of arbitrarily applying raw bold or italic markup in a sentence. If there's a suitable macro, use that instead. If there isn't a suitable macro, write one or request one.
Use simple backticks (`...`) for fragments of WikiText, but not for the names of things like fields and widgets. These have their own macros.
To keep things clean and simple, quotation marks and apostrophes should be straight ', not curly ’, and the ellipsis should be three separate dots ... rather than ….
Use " as the primary quotation mark, reserving ' for the rare case of a nested quotation.
Avoid using a single hyphen - as sentence punctuation. Instead, use a double hyphen – which TiddlyWiki renders as an en-dash – with a space on either side.
Items in lists and tables should only end with a full stop (period in US English) if they are complete sentences. They should have no trailing punctuation otherwise.
It is very rarely necessary to use an exclamation mark in professional documentation.
Standalone Configuration
Follow these instructions when using TiddlyWiki as a standalone HTML file:
- Create a backup of your current TiddlyWiki HTML file (just in case)
- Open the control panel and go to the Plugins tab
- Click on the plugin you want to delete to open its tiddler
- Click the more button and delete the tiddler
- Save your TiddlyWiki
- Refresh the window so that TiddlyWiki completely removes the plugin
- The plugin should now be deleted
Client-Server Configuration
Follow these instructions when using TiddlyWiki under Node.js:
- Quit the server if it is running
- Edit the
tiddlywiki.infofile (it is in JSON format) and locate thepluginsandthemessection (see below) - Remove the entries corresponding to the plugins you wish to remove. Take care to retain commas to separate items, but do not terminate the last item in a list with a comma
- Restart the server
{
"plugins": [
"tiddlywiki/codemirror"
],
"themes": [
"tiddlywiki/vanilla",
"tiddlywiki/snowwhite"
]
}Extrait les tiddlers utiles d'un plugin, en les créant sous forme de tiddlers ordinaires :
--unpackplugin <titre>| purpose | discard any input titles that have tags |
|---|---|
| input | a selection of titles |
| parameter | none |
| output | those input tiddlers that have no tags |
! output | those input tiddlers that have at least one tag |
A tiddler is deemed to have no tags if it:
- doesn't exist
- doesn't have a
tagsfield - has an empty
tagsfield
- Open upgrade.html
- Includes a data tiddler called
$:/UpgradeLibrarythat contains the latest compatible versions of all plugins in the library - Drag in old wiki file
- Place tiddlers into a data tiddler
$:/Importthat is typed as a "pending import" - Kick off import processing for each tiddler
- Give each "upgrader" module a chance to inspect the incoming tiddlers
- Upgrader modules can trigger actions for each tiddler:
- Display a warning message
- Don't import
- Replace with another tiddler from the upgrade library
- Disable incompatible plugins
- Display the newly created pending import tiddler through a new view template segment
- Displays the payload tiddlers as a list of titles and checkboxes, with a dropdown showing the full details of the tiddler
- Perhaps we also suppress the usual JSON display for data tiddlers behind a reveal widget
- The user can adjust the selection checkboxes
- Clicking "Upgrade" unpacks the selected tiddlers from the pending import tiddler
- The pending import tiddler and the upgrade library tiddler are excluded from the subsequent save operation
De nouvelles versions de TiddlyWiki sont publiées régulièrement, avec des améliorations et des corrections de bogues. Il est recommandé de rester à jour en hissant votre wiki au niveau de la dernière version.
Introduction
La procédure décrite ici est réservée à la mise à niveau de fichiers TiddlyWiki autonomes. Pour mettre à niveau TiddlyWiki sur Node.js, il existe une méthode différente.
Quand vous mettez à niveau, n'oubliez pas la première règle d'utilisation de Tiddlywiki :
Il est de votre responsabilité de vous occuper de vos données ; prenez soin d'effectuer des sauvegardes, surtout quand vous mettez à niveau le noyau de TiddlyWiki.
Mise à niveau en ligne
Cette procédure fonctionnera sur la plupart des navigateurs de bureau. Notez que vos données personnelles ne quittent pas votre navigateur pendant la procédure.
- Localisez votre fichier TiddlyWiki sur le système de fichiers (à l'aide de Windows Explorer, du Finder sur Mac OS X, ou de votre gestionnaire de fichiers sur Linux)
- Visitez la page https://tiddlywiki.com/upgrade.html dans votre navigateur
- Faites glisser votre ancien fichier TiddlyWiki HTML sur la fenêtre du navigateur
- Si le fichier est crypté, un mot de passe vous sera demandé
- Passez en revue la liste des tiddlers qui seront mis à niveau
- Cliquez sur Upgrade
- Enregistrer les changements pour sauvegarder la nouvelle version
Cela aura pour résultat de télécharger sur votre ordinateur un fichier nommé upgrade.html. Ce fichier constitue la version à niveau de votre ancien fichier. Il se peut que vous deviez vous rendre là où upgrade.html a été téléchargé, renommer upgrade.html avec le nom de l'ancien fichier que vous mettez à niveau, et remplacer l'ancien fichier en déplaçant le nouveau à sa place.
Mise à niveau hors ligne
Vous pouvez également télécharger le fichier https://tiddlywiki.com/upgrade.html localement et effectuer la même procédure de glisser-déposer pour mettre vos fichiers à niveau.
Problèmes avec les mises à niveau
Il est possible qu'une personnalisation appliquée dans une version précédente devienne inopérante une fois la mise à niveau effectuée. Deux techniques peuvent être employées pour vous aider à retrouver l'origine du problème :
- Essayez de répéter la mise à niveau en décochant tous les tiddlers qui pourraient contenir des personnalisations de TiddlyWiki
- Utilisez le ModeSansÉchec pour désactiver toutes les adaptations personnalisées des tiddlers shadow
Vous pouvez voir quels tiddlers shadow ont été modifiés dans l'onglet Filtres de la recherche avancée. Choisir "Les tidders shadow modifiés" depuis le menu déroulant.
Si vous avez installé TiddlyWiki sur Node.js de manière standard, vous pouvez le mettre à jour dès qu'une nouvelle version est publiée, à l'aide de la commande suivante :
npm update -g tiddlywikiSur Mac ou Linux, vous devrez ajouter sudo :
sudo npm update -g tiddlywikiUne URI (souvent aussi connue comme URL) est une chaine de caractère utilisée pour spécifier la localisation d'une ressource telle qu'une page web.
By default, when running TiddlyWiki on Node.js, the server exposes the wiki at the URI formed from the protocol, host and port - for example, http://127.0.0.1:8080/.
There are two steps to running the wiki at a custom path like http://127.0.0.1:8080/path/to/my/wiki/:
- Configure the server by passing
/path/to/my/wikias the pathprefix argument of the ServerCommand - Configure the client by creating a tiddler called
$:/config/tiddlyweb/hostthat contains$protocol$//$host$/path/to/my/wiki/
By default, TiddlyWiki's WebServer serves resources over the insecure HTTP protocol. The risk is minimal if it is only being used within a private, trusted network but in many situations it is desirable to use a secure HTTPS connection.
HTTPS requires the server to be configured with a certificate via a "cert" file and a "key" file, configured via the tls-cert and tls-key parameters
Certificates can be obtained from a certification authority such as https://letsencrypt.org/, or you can create a self-signed certificate for internal testing.
To create the required certificate files with the popular openssl utility:
openssl req -newkey rsa:2048 -new -nodes -keyout mywikifolder/key.pem -out mywikifolder/csr.pem
openssl x509 -req -days 365 -in mywikifolder/csr.pem -signkey mywikifolder/key.pem -out mywikifolder/server.crt
tiddlywiki mywikifolder --listen username=joe password=bloggs tls-key=key.pem tls-cert=server.crtVous pouvez utiliser des liens (habituellement affichés en bleu)pour naviguer d'un tiddler à l'autre. Cliquer sur le lien vers un tiddler vous amène à ce tiddler. Si le tiddler est fermé, il sera ouvert. La particularité de TiddlyWiki est de rendre les liens vers tiddlers aussi accessible que possible. Il y a des liens partout ! Voici les principaux endroits où vous pourrez trouver des liens vers d'autres tiddlers dans TiddlyWiki :
- Vous pouvez créer un lien vers un tiddler, qu'il existe déjà ou pas, dans le contenu de tout tiddler. Voir Liens avec WikiTexte pour consulter les différentes façons de créer simplement des liens entre tiddlers.
- Chaque tag de votre tiddler (comme par exemple le tag Working with TiddlyWiki sous le titre de ce tiddler) contient un lien vers ce tiddler tag, ainsi que la liste de tous les tiddlers avec ce tag. Ce qui vous permet d'ouvrir un de ces tiddlers.
- Le Panneau d'information de chaque tiddler vous donne l'accès à 4 onglets contenant un liste additionnelle de tiddlers connexes :
- L'onglet Références liste tous les tiddlers avec un lien vers le tiddler en cours.
- L'onglet Étiqueté liste tous les tiddlers tagués avec le titre du tiddler en cours.
- L'onglet Liste liste tous les tiddlers (ou les tiddlers potentiels) mentionnés dans le champ liste du tiddler en cours.
- L'onglet Listé liste tous les tiddlers qui mentionnent le tiddler en cours dans leurs champs liste.
- Les onglets de la barre de menu contiennent plusieurs listes de liens vers des tiddlers :
- L'onglet Récents liste les 100 tiddlers récemment modifiés, en commençant pas la modification la plus récente.
- L'onglet Plus propose 8 listes supplémentaires de tiddlers :
- Tout liste tous les tiddlers dans l'ordre alphabétique.
- Tags liste tous les tags. Vous pouvez cliquer sur la pilule de tout tag pour accéder à la liste des tiddlers étiquetés par ce tag.
- Manquants liste tous les tiddlers qui n'existent pas encore, mais auquels sont liés à d'autres tiddlers. Utile pour trouver les tiddlers que vous aviez prévu de créer, sans en avoir jamais eu le temps.
- Ébauches liste tous les tiddlers actuellement en mode ébauche. TiddlyWiki considère l'ébauche d'un tiddler comme un tiddler séparé de l'original aussi longtemps que vous le modifiez, aussi, tant que vous modifierez le tiddler titré Australie, il y aura deux tiddlers, Australie et Draft of 'Australie'. Quand vous clôturerez l'ébauche en confirmant les modifications, ces modifications seront apportées au tiddler original Australie. Aussi, traitez l'onglet Ébauches comme un moyen de retrouver toutes les ébauches que vous avez commencé.
- Orphelins liste tous les tiddlers non connectés à un autre tiddler par des lien, tag ou liste. C'est une assistance utile à l'organisation de vos fichiers - qui montre quels tiddlers doivent y faire l'objet d'une intégration plus soigneuse.
- Types liste tous les tiddlers à contenu spécial, comme les images ou l'audio.
- Système liste tous les SystemTiddlers.
- Shadows liste tous les ShadowTiddlers.
- Résultats de la recherche est une liste des tiddlers contenant le texte que vous avez saisi dans la zone de recherche.
- Enfin, vous pouvez créer vos propres tiddlers de listes personnalisées par différents moyens :
- Vous pouvez transclure un filtre (voir Transclusion grâce à WikiText). Par exemple, l'ajout de
{{{ [tag[montagne]] }}}à un tiddler insèrera une liste de tiddlers avec le tag montagne. - Vous pouvez utiliser le ListWidget. C'est plus compliqué que transclure un filtre, mais offre plus de souplesse dans l'affichage et la mise en forme d'une liste exactement de la façon dans laquelle vous désirez qu'elle s'affiche.
- Vous pouvez transclure un filtre (voir Transclusion grâce à WikiText). Par exemple, l'ajout de
Les premières étapes pour changer l'apparence de TiddlyWiki sont de choisir et d'appliquer un des thèmes disponibles, ou de modifier la palette de couleurs.
De plus, les feuilles de style CSS personnalisées peuvent être définies en taguant un tiddler par $:/tags/Stylesheet. Essayez de créer une feuille de style maintenant avec le contenu suivant pour modifier la couleur de fond de la page à rouge :
html body.tc-body {
background: red;
}Outrepasser les réglages du thème
Les feuilles de style personnalisées sont appliquées indépendamment de celles du thème. Toutefois, il est souvent nécessaire aux règles css de votre feuille de style d'être plus spécifiques que celles du thème auquel vous désirez vous substituer. Ainsi, html body.tc-body sera plus pointu que body.tc-body.
Les types de feuille de style
Il est en général bien mieux de faire appel au text/css pour les feuilles de styles. Cela les interprète comme des feuilles de style à part entière, et assure que TiddlyWiki ne leur applique aucun processus wiki.
Si vous souhaitez utiliser macros et transclusions au sein de vos feuilles de style vous devrez y substituer le type WikiTexte par défaut text/vnd.tiddlywiki. Ce qui permettra a une interprétation WikiTexte d'être complètement appliquée. Voilà un exemple :
\rules only filteredtranscludeinline transcludeinline macrodef macrocallinline html
body.tc-body pre {
<<box-shadow "inset 0 1px 0 #fff">>
}Le pragma \rules au début du tiddler restreint l'application WikiTexte aux seules macros et transclusions. Sont ainsi évités les déclenchements de processus WikiTexte erronés indésirables.
Un tiddler feuille de style est interprété de façon telle qu'il est, dans un premier temps wikifié et la portion de texte en résultant est extraite pour être considéré comme du CSS. Toute balise HTML que vous utiliseriez dans votre feuille de style est ainsi ignorée. Par exemple, les éléments HTML générés par le RevealWidget n'affecteront pas le résultat en sortie. Comme dans l'exemple suivant, vous pouvez entourer les règles de balises <pre> pour les afficher comme des blocs de code sans affecter leur interprétation, incluant la prise en compte de la macro entourée.
\rules only filteredtranscludeinline transcludeinline macrodef macrocallinline html
<pre>body.tc-body pre {
<<box-shadow "inset 0 1px 0 #fff">>
}
</pre>Macros feuille de style
Le noyau de TiddlyWiki offre plusieurs macros globales that are helpful dans l'élaboration des feuilles de style .
TiddlyWiki5 allows you to use SVG to display vector graphics in two ways:
- Tiddlers with the type
image/svg+xmlare interpreted as SVG images, and displayed and transcluded as self-contained<img>elements with the SVG embedded as a data URI in thesrcattribute.- For examples of SVG images see Motovun Jack.svg and Tiddler Fishes.svg
- WikiText can also include inline SVG elements directly. See below for an example.
Embedding SVG tiddlers
You can embed an SVG image tiddler using the ordinary transclusion syntax:
{{Motovun Jack.jpg}}You can also use Typed Blocks in WikiText to embed an inline SVG tiddler.
The implications of the image being rendered within an <img> element are that it is sandboxed; it can't use CSS styles from the parent document, for example. Neither can the image use WikiText features like transclusion.
Embedding SVG elements
The other way to use SVG is to embed the <svg> element directly. For example:
Note that inline SVG elements don't need an <?xml version="1.0"?> directive.
Including HTML or WikiText content in SVG images
You can include simple text strings in SVG images using the <text> element:
HTML or WikiText content can be included within inline SVG images using the <foreignObject> element. For example:
Transcluding SVG elements
When embedding SVG elements you can also use WikiText features like transclusion. For example, here is an SVG circle with the radius set to the value in the tiddler $:/SVGExampleRadius:
You can edit the value of the radius here:
Making curved text with SVG
Cette démonstration montre comment utiliser SVG pour faire suivre un chemin incurvé à un texte transclu. Entrez du texte dans la zone çi-dessous pour essayer ; visualiser le code source pour voir examiner le fonctionnement.
Setting the root-tiddler parameter to $:/core/save/all-external-js switches to a special template that externalises TiddlyWiki's core JavaScript into a separate file. For example:
tiddlywiki editions/tw5.com-server/ --listen host=0.0.0.0 "root-tiddler=$:/core/save/all-external-js"Background
TiddlyWiki in the single file configuration ordinarily packs everything into a single file: your data, and the JavaScript, CSS and HTML comprising TiddlyWiki itself. This lack of dependencies is usually very convenient: it means that it is impossible for the parts of a TiddlyWiki to become separated, and enormously improves the changes of it still functioning in the future.
However, there is some inefficiency in this arrangement because the core code is repeatedly loaded and saved every time the content of the wiki is saved. This inefficiency is partially ameliorated when working in the client server configuration because once the wiki is loaded by the browser the synchronisation process only transmits individual tiddlers back and forth to the server.
The remaining inefficiency when working in the client server configuration is that the single page wiki that is initially loaded will contain a copy of the entire core code of TiddlyWiki, making it impossible for the browser to cache it.
Any files in the subfolder files of the wiki folder will be available via the route \files\<uri-encoded-filename>. For example: http://127.0.0.1:8080/files/Motovun%20Jack.jpg
This can be useful for publishing large files that you don't want to incorporate into the main wiki (PDFs, videos, large images, etc.).
Static files can be referenced directly:
[ext[./files/a-big-document.pdf]]- to make a link to a PDF[img[./files/a-big-image.png]]- to embed an image
Alternatively, the _canonical_uri field can be used to reference the files as external tiddlers.
TiddlyWiki's experimental single tiddler per page, read-only view uses a simplified page layout, and implements links between tiddlers, but there are no other interactive features. Compared to a full TiddlyWiki user interface, it is very lightweight and usable even over very slow connections.
Alongside serving the full interactive wiki at the path / (e.g. http://127.0.0.1:8080/), TiddlyWiki serves each tiddler at the path /<url-encoded-tiddler-title>. For example:
Ordinary, non-system tiddlers are rendered through a special view template while system tiddlers are rendered through a template that returns the raw text of the rendered output. In this way ordinary tiddlers can be browsed by end users while system tiddlers can be included in their raw form to use them as JS, HTML or CSS templates. Additionally these defaults can be overwritten on a per tiddler basis by specifying the _render_type and _render_template fields accordingly.
The templates are controlled by these parameters:
TiddlyWiki5 can be used to produce documentation for GitHub projects. It lets you maintain a single set of documentation as a TiddlyWikiFolder containing separate tiddler files under source code control, and then use it to produce readme.md files for inclusion in project folders, or HTML files for storage in GitHub Pages. Both features are demonstrated by TiddlyWiki5 itself.
Generating readme.md files
When displaying the contents of a folder GitHub will look for a readme.md file and display it. Note that it will not display full HTML files in this way, just static MarkDown files (this is a security measure). Happily MarkDown permits a safe subset of HTML, and thus to generate a readme.md file that is suitable for GitHub it is just necessary for TiddlyWiki5 to generate the content of the <body> element of an HTML document, and give it the appropriate filename.
This is done with this command:
--rendertiddler ReadMe ./readme.md text/htmlIt saves the tiddler ReadMe to the file ./readme.md in the text/html format.
By default, tiddler links will be rendered as <a> links to a relative URI consisting of the title of the tiddler. This behaviour can be overridden by defining the macro tv-wikilink-template, as is done at the top of the tiddler ReadMe:
\define tv-wikilink-template() https://tiddlywiki.com/static/$uri_doubleencoded$.htmlSee the LinkWidget for more details.
In this example, tiddler links are rendered as links to the static rendering of tw5.com.
TiddlyWiki5 peut être utilisé depuis la ligne de commande, dans le but d'effectuer un ensemble d'opérations qui manipulent dossiers TiddlyWiki, fichiers de tiddlers et fichiers TiddlyWiki.
Par exemple, la commande ci-dessous charge les tiddlers d'un fichier TiddlyWiki HTML, et enregistre l'un d'eux dans un fichier HTML statique :
tiddlywiki --verbose --load monwiki.html --rendertiddler LisezMoi ./lisezmoi.htmlL'exécution du programme tiddlywiki depuis la ligne de commande démarre le noyau TiddlyWiki, charge les plugins de base et met en place une structure de wiki vide. Puis les arguments de la ligne de commande sont traités à la suite, de gauche à droite. Les arguments sont séparés par des espaces.
Le premier argument est un chemin optionnel vers le dossier à charger. Si absent, le répertoire courant est utilisé.
Suivent les commandes proprement dites, avec leurs arguments spécifiques, chaque commande étant annoncée par le préfixe --.
tiddlywiki [<cheminverslewiki>] [--<commande> [<arg>[,<arg>]]]Les commandes disponibles sont :
TiddlyWiki5 propose d'afficher les illustrations vectorielles SVG de deux façons :
- Les Tiddlers avec le type
image/svg+xmlsont interprétés comme des images SVG, et affichés et transclus des éléments<img>autonomes avec du code SVG intégré (le lien URI vers les données source est dans l'attributsrc)- Exemples d'images SVG, voir Motovun Jack.svg et Tiddler Fishes.svg
- WikiText peut aussi inclure directement des éléments SVG en ligne. Voir ci-dessous pour un exemple.
Intégration de tiddlers SVG
Vous pouvez intégrer un tiddler image SVG en utilisant la syntaxe ordinaire de transclusion :
{{Motovun Jack.jpg}}De même, vous pouvez faire appel aux blocs typés pour intégrer un tiddler SVG en mode ligne.
Toutefois, le rendu de l'image par l'élément <img> fait qu'elle passe par un bac à sable, et ne peut pas récupérer les styles CSS du document parent, par exemple. L'image, en elle-même, ne peut pas utiliser de fonctionnalités WikiText comme la transclusion.
Intégration d'éléments SVG
L'autre façon d'utiliser SVG est d'intégrer des éléments <svg> directement. Par exemple :
Notez que les éléments SVG en mode ligne ne nécessitent pas de directive <?xml version="1.0"?>.
Inclure du contenu HTML ou WikiText dans des images SVG
Vous pouvez inclure de simples chaine de texte dans des images SVG par l'emploie de l'élément <text> :
Le contenu HTML or WikiText peut être inclu dans des images en mode ligne via l'élément <foreignObject>. Par exemple :
Transclusion d'éléments SVG
Lors de l'intégration d'éléments SVG vous pouvez faire appel à des fonctionnalités WikiText comme la transclusion. Par exemple, voici un cercle SVG dont la valeur du rayon est réglée dans le tiddler $:/SVGExampleRadius :
Vous pouvez modifier la valeur du rayon :
Tracer un texte incurvé avec SVG
Cette démonstration montre comment utiliser SVG pour faire suivre un chemin incurvé à un texte transclu. Entrez du texte dans la zone çi-dessous pour essayer ; visualiser le code source pour voir examiner le fonctionnement.
Une variable est une portion de texte accessible par son nom via une branche particulière de l'arbre widget. La portion reconnue est la valeur de la variable.
Une nouvelle variable est définie par le widget $set, et ainsi accessible à tous les descendants du widget, incluant les contenus tranclus. Un widget $set peut utiliser un nom existant et relier ainsi, une portion différente à ce nom pour cette génération de descendants du widget.
Le widget $list affecte aussi une variable particulière (par défaut currentTiddler), tour à tour, à chaque titre listé.
Pour une vue d'ensemble quand à l'utilisation des variables, se reporter à variables dans Wikitexte .
Malgré le mot "variable", chaque portion contient une chaine constante. L'apparente variabilité est actuellement reflétée par la présence de plusieurs variables portant le même nom en différents endroits de l'arbre widget.
WikiTexte n'analyse pas les portions en elles-mêmes. Cependant la référence à une variable peut être transcluse dans un contexte où une analyse WikiText parsing may pourrait s'effectuer. Dans une portion de code, le seul marquage détecté est $name$ pour le paramètre de transclusion d'une macro et $(name)$ pour une variable à transclure.
La macro dumpvariables liste toutes les variables (y compris les macros) disponibles à une position donnée de l'arbre widget.
Le noyau de TiddlyWiki intègre plusieurs variables.
Voir aussi une introduction au concept de variables.
Pour transclure la valeur d'une variable, utilisez la syntaxe d'appel de macro sans paramètres. Vous pouvez aussi utiliser un widget $macrocall.
Le code d'une macro snippet peut contenir une zoneréservée $(name)$ où la valeur d'une variable sera substituée à son nom.
La valeur d'une variable peut être utilisée comme paramètre de filtre, ou comme attribut de widget. Ce dernier prenant en charge les paramètres de macro.
Exemple : définition d'une variable
<$set name=animal value=zèbre>
<<animal>>
</$set>Exemple: définition d'une macro
Le pragma \define çi-après définit une macro nommée tags. La macro renvoie la valeur du champ tags du tiddler, et peut être appelé partout dans le tiddler (ou dans tout tiddler qui l'importe).
\define tags-of-current-tiddler() {{!!tags}}
Les tags sont<<:>> <<tags-of-current-tiddler>>Exemple : utilisation de variables comme paramètres de filtre
Cet exemple utilise l'opérateur backlinks pour lister tous les tiddlers liés à celui-çi.
<<list-links filter:"[<currentTiddler>backlinks[]]">>Introduction
The vars widget allows multiple variables to be set in one operation. In some situations it can result in simpler code than using the more flexible SetWidget.
Content and Attributes
The content of the <$vars> widget is the scope for the value assigned to the variable.
| Attribute | Description |
|---|---|
| {attributes not starting with $} | Each attribute name specifies a variable name. The attribute value is assigned to the variable |
Examples
Consider a case where you need to set multiple variables.
Using the <$vars> widget, this situation may be handled in the following way:
\define helloworld() Hello world!
<$vars greeting="Hi" me={{!!title}} sentence=<<helloworld>>>
<<greeting>>! I am <<me>> and I say: <<sentence>>
</$vars>In contrast, here is the same example using the <$set> widget:
<$set name="greeting" value="Hi" >
<$set name="me" value={{!!title}} >
<$set name="sentence" value=<<helloworld>> >
<<greeting>>! I am <<me>> and I say: <<sentence>>
</$set>
</$set>
</$set>Remarks
It should be noted that this widget differs from the set widget in the following ways:
- A fallback (also known as "emptyValue") cannot be specified
- Filters cannot be used to produce a conditional variable assignement
- Variable names must be literal strings
The following TiddlyWiki videos are available.
- OXTWIG
- Les Vidéo-conférences TiddlyWiki
- Bien démarrer en vidéo
- Vidéo d'introduction à TiddlyDesktop
- Introduction Vidéo
- Vidéo de TiddlyWiki sur Firefox pour Android
The aim is to curate a series of videos to guide people through getting up and running with TiddlyWiki. Contributions are welcome.
Introduction
Le widget view affiche le contenu du champ d'un tiddler dans un format spécifié.
Contenu et Attributs
Le contenu du widget <$view> est affiché si le champ ou une propriété est vide ou manquante.
| Attribut | Description |
|---|---|
| tiddler | Le titre du tiddler (par défaut du tiddler courant) |
| field | Le nom du champ à afficher (par défaut "texte") |
| index | Le nom de l'index à afficher |
| format | Le format d'affichage du champ (voir ci-dessous) |
| template | Une chaine de gabarit optionnelle utilisée avec certains formats comme les dates |
| subtiddler | Le titre d'un SubTiddler optionnel quand le tiddler cible est un plugin (voir ci-dessous) |
Formats
Les formats suivants peuvent être spécifiés dans l'attribut format :
| Format | Description |
|---|---|
| text | text brut |
| htmlwikified | Le champ est wikifié et la résultante HTML retourné comme du texte brut |
| htmlencoded | Le champ est affiché jusqu'à l'encodage HTML |
| date | Le champ est interprété comme une date UTC date et affiché selon le format de date spécifié dans l'attribut template |
| relativedate | Le champ est interprété comme une date UTC date et affiché comme un intervalle au moment présent |
| stripcomments | Le champ est considéré comme du code source JavaScript et toutes les lignes commençant par \\# sont écartées |
| jsencoded | Le champ est affiché comme une chaine encodée en JavaScript |
Accès au SubTiddler
Le widget view permet l'accès aux tiddlers individuels stockés dans un plugin.
L'exemple suivant montre la version originale du tiddler $:/DefaultTiddlers même s'il a été remplacé :
<$view tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>
Affichera ceci :
GettingStartedAn interactive timeline visualisation plugin based on Vis.js. A demo can be found here: http://kixam.github.io/TW5-visjsTimeline/.
vis.js Timeline is a TiddlyWiki plugin that allows you to link your wiki-topics (tiddlers) in order to create clickable timelines. This project is a direct continuation of emkay's plugin.
When running under Node.js, TiddlyWiki includes a simple HTTP/HTTPS web server that allows you to use it from any browser running on the same machine or over a network.
How It Works
The web server listens for requests coming over the network, and performs the following actions in turn:
- Authentication is the process of identifying the current user. TiddlyWiki supports three types of authentication: Anonymous, Basic and Header
- Authorization is the process of determining which resources may be accessed by a particular user. TiddlyWiki implements a simple scheme whereby read and write access to the wiki can be independently controlled.
- Routing is the process of dispatching the request to the API handler, and returning any required data.
Usage
Anonymous Access
The web server is started with the ListenCommand (which supersedes the older ServerCommand). All the NamedCommandParameters are optional, so the simplest form is:
tiddlywiki mywikifolder --listenVisit http://127.0.0.1:8080/ to access the wiki. Access is anonymous, so anyone can read or write to the wiki.
This will typically be available only to users on the local machine. For information on how to open the instance to the local network see the Web Server host parameter entry.
Authenticated Access
Adding username and password parameters enforces basic authentication for both reading and writing:
tiddlywiki mywikifolder --listen username=test password=tsetVisiting the wiki will prompt for a username and password, and access is denied if they do not match the provided credentials.
Anonymous Read, Authenticated Write
This example adds the authorization parameters readers and writers to grant read access to anonymous users, but require authentication as "joe" in order to gain write access.
Note that anonymous users can trigger a username/password prompt by visiting the route
\login-basic(eg http://127.0.0.1:8080/login-basic).
tiddlywiki mywikifolder --listen "readers=(anon)" writers=joe username=joe password=bloggsNote the double quotes that are required for parameters containing special characters.
Arguments
The full list of available optional parameters is:
- anon-username
- authenticated-user-header
- credentials
- csrf-disable
- debug-level
- host
- password
- path-prefix
- port
- readers
- root-render-type
- root-serve-type
- root-tiddler
- system-tiddler-render-template
- system-tiddler-render-type
- tiddler-render-template
- tiddler-render-type
- tls-cert
- tls-key
- username
- writers
Guides
Further information on usage of the integrated WebServer:
The TiddlyWiki WebServer API supports the following routes:
- WebServer API: Delete Tiddler
- WebServer API: Force Basic Authentication Login
- WebServer API: Get All Tiddlers
- WebServer API: Get Favicon
- WebServer API: Get File
- WebServer API: Get Rendered Tiddler
- WebServer API: Get Server Status
- WebServer API: Get Tiddler
- WebServer API: Get Wiki
- WebServer API: Put Tiddler
Delete a tiddler
DELETE /bags/default/tiddlers/{title}Parameters:
- title - URI encoded title of the tiddler to delete
Response:
- 204 No Content
Forces the server to request basic authentication login, and then redirects to the root
GET /login-basicRequests an basic authentication from the browser, and redirects to the root if successful.
Parameters:
- none
Response:
- 302 Found
Location: / - 401 Unauthorized
WWW-Authenticate: Basic realm="Please provide your username and password to login to <servername>"
Gets an array of all raw tiddlers, excluding the text field.
GET /recipes/default/tiddlers.jsonParameters:
- none
Response:
- 200 OK
Content-Type: application/jsonBody: array of tiddlers in TiddlyWeb JSON tiddler format
Get the favicon for the wiki from the tiddler $:/favicon.ico
GET /favicon.icoParameters:
- none
Response:
- 200 OK
Content-Type: image/x-iconBody: image data from the tiddler $:/favicon.ico
Get the content of a static file. See using the integrated static file server
GET /files/<pathname>Parameters:
- pathname - URI encoded path to the file
Response:
- 200 OK
Content-Type: <content-type>(determined from file extension)Body: data retrieved from file
- 403 Forbidden
- 404 Not Found
Gets a rendering of the specified tiddler. See using the read-only single tiddler view for more details.
GET /{title}Parameters:
- title - URI encoded title of the tiddler to render
Response:
- 200 OK
Content-Type: <content-type>Body: tiddler rendering
- 404 Not Found
Get server status information
GET /statusParameters:
- none
Response:
- 200 OK
Content-Type: application/jsonBody: see below
The JSON data returned comprises the following properties:
- username - the username of the currently authenticated user. If undefined, the WebServer Parameter: anon-username is returned instead
- anonymous - true if the current user is anonymous
- read_only - true if the current user is restricted to read only access to the server
- space - always contains the object
{recipe: "default"} - tiddlywiki_version - the current TiddlyWiki version
For example:
{
"username": "",
"anonymous": true,
"read_only": false,
"space": {
"recipe": "default"
},
"tiddlywiki_version": "5.1.18"
}Gets the raw fields of a tiddler
GET /recipes/default/tiddlers/{title}Parameters:
- title - URI encoded title of the tiddler to retrieve
Response:
- 200 OK
Content-Type: application/jsonBody: tiddler in TiddlyWeb JSON tiddler format
- 404 Not Found
Get the main wiki
GET /The wiki is composed by rendering the tiddler identified in the root-tiddler parameter with the render type in the root-render-type parameter. This is then served with the content type from the root-serve-type parameter.
Parameters:
- none
Response:
- 200 OK
Content-Type: text/htmlBody: data retrieved from file
Saves the raw fields of a tiddler
PUT /recipes/default/tiddlers/{title}The body should be in TiddlyWeb JSON tiddler format.
Parameters:
- title - URI encoded title of the tiddler to save
Response:
- 204 No Content
Content-Type: text/plainEtag: "default/<title>/<changecount>:"
Authentication is the process of identifying the current user. TiddlyWiki supports three types of authentication:
- Anonymous Access allows any user to access resources without requiring authentication. Optionally, a username can still be specified for signing edits
- Basic Authentication requires the user to enter a username and password combination which TiddlyWiki validates against an internal database of credentials
- Header Authentication requires an external proxy to place the username of the current user in a trusted header of the request. It is often used as the basis of "single sign-on" features
Authorization is the process of determining which resources may be accessed by a particular user. It occurs after authentication has determined the identity of the user. TiddlyWiki's WebServer implements a simple authorization scheme which permits independent control of who has read and write access to a wiki.
The WebServer parameters readers and writers each contain a comma separated list of principals (which is to say, either usernames or certain special tokens) which should have read or write access respectively.
The available special tokens are:
- (anon) - indicates all anonymous users
- (authenticated) - indicates all authenticated users
Read-only Mode
Read-only mode is engaged when the current user is not authorized to write to the current wiki.
User interface features concerned with creating or editing content are disabled in read-only mode:
- clone, delete, new-here and new-journal-here tiddler toolbar buttons
- import, manager, new-tiddler new-image and new-journal page control buttons
The tiddler $:/status/IsReadOnly is set to yes when read-only mode is engaged.
Examples
These example use the credentials parameter to specify the location of a file containing usernames and passwords.
In the first example, read access is permitted for the users "joe" and "mary", with write access restricted to "mary":
tiddlywiki mywikifolder --listen credentials=myusers.csv readers=joe,mary writers=maryIn the following example, read access is granted to all authenticated users, but only "mary" is granted write access:
tiddlywiki mywikifolder --listen credentials=myusers.csv "readers=(authenticated)" writers=maryBasic authentication is a standard mechanism for servers to instruct browsers to prompt the user for credentials. It is recommended to use it in association with HTTPS due to the way that it passes unencrypted passwords over the network.
Basic authentication is activated if credentials are specified via the username/password or credentials parameters.
If WebServer Authorization is configured to allow access by both anonymous and authenticated users then by default users will not be prompted for credentials, and will be given anonymous access. To force a password prompt visit the route /login-basic (for example, http://127.0.0.1:8080/login-basic).
Header authentication is a web integration technique enabling external entities to securely pass details of the authenticated user to an application. It is commonly used for "single sign on" in corporate environments.
Header authentication is activated if is configured via the authenticated-user-header
The web server configuration parameter anon-username provides an optional username for signing edits from anonymous users.
Without this parameter, anonymous users will be given a blank username.
The web server configuration parameter authenticated-user-header activates header authentication by specifying the name of the HTTP header that will be used to pass the username to TiddlyWiki.
The web server configuration parameter credentials contains the pathname of a CSV file containing a list of username/password combinations. Using the credentials parameter activates WebServer Basic Authentication.
The CSV file must contain a header row and columns labelled username and password. For example:
username,password
jane,do3
andy,sm1th
roger,m00reNotes:
The web server configuration parameter csrf-disable causes the usual cross-site request forgery checks to be disabled. This might be necessary in unusual or experimental configurations.
The only currently implemented check is the use of a custom header called x-requested-with that must contain the string TiddlyWiki in order for write requests to succeed.
The web server configuration parameter debug-level determines the level of debugging information printed to the console:
- full - maximum logging
- none - no logging
The web server configuration parameter host is the IP address on which the server listens. The most common settings are:
- 127.0.0.1 (default) - only listens for connections from browsers on the same computer
- 0.0.0.0 - listens for connections on all network interfaces, and thus from any browser on a reachable network
- n.n.n.n - listens for connections on the network interface with the specified IP address
Note: Using 0.0.0.0 or n.n.n.n in a public environment (e.g. coffee shop, library, airport) is inadvisable as it will expose your system to possible intrusion.
The web server configuration parameter password, is used with its companion username as a shortcut for setting user credentials for WebServer Basic Authentication.
The web server configuration parameter path-prefix can be used to set an optional prefix for all paths served.
This example causes the server to serve from http://127.0.0.1/MyApp instead of the default http://127.0.0.1/MyApp.
tiddlywiki mywikifolder --listen "path-prefix=/MyApp"The web server configuration parameter port specifies the TCP port on which the server will listen for connections. The default value is 8080.
The port parameter accepts two types of value:
- Numerical values are interpreted as a decimal port number
- Non-numeric values are interpreted as an environment variable from which the port should be read
This example configures the server to listen on port 8090:
tiddlywiki mywikifolder --listen port=8090This example configures the server to listen on the port specified in the environment variable THE_PORT:
tiddlywiki mywikifolder --listen port=THE_PORTThe web server configuration parameter readers is used to specify the security principals with read access to the wiki. See WebServer Authorization for more details.
The web server configuration parameter root-render-type determines the way that the root wiki tiddler is rendered:
text/plain(default) – the plain text content of the output is rendered (i.e. HTML elements are ignored)text/html– the full HTML content of the output is rendered (i.e. including HTML elements)
The web server configuration parameter root-serve-type determines the content type with which the root wiki tiddler is rendered. The default is text/html.
The web server configuration parameter root-tiddler determines the title of the tiddler that is rendered as the root wiki. The default setting is $:/core/save/all.
The web server configuration parameter system-tiddler-render-template is used to specify the template for serving system tiddlers in the read-only single tiddler view. The default value is $:/core/templates/wikified-tiddler which renders the tiddler raw, without any special viewing template.
The web server configuration parameter system-tiddler-render-type is used to specify the render type for serving system tiddlers in the read-only single tiddler view. The default value is text/plain, causing the raw text of rendered system tiddlers to be returned. Alternatively, text/html can be used to cause the full HTML of the rendered tiddlers to be returned.
The web server configuration parameter tiddler-render-template is used to specify the template for serving ordinary, non-system tiddlers in the read-only single tiddler view. The default value is $:/core/templates/server/static.tiddler.html which renders tiddlers in a lightweight page with a simple sidebar.
The web server configuration parameter tiddler-render-type is used to specify the render type for serving ordinary, non-system tiddlers in the read-only single tiddler view. The default value is text/html, causing the full HTML of the rendered output to be returned. Alternatively, text/html can be used to cause the raw text of rendered system tiddlers to be returned.
The optional web server configuration parameter tls-cert contains the pathname to the certificate file required when running the web server under HTTPS. The pathname is taken relative to the wiki folder.
See Using HTTPS for details.
The optional web server configuration parameter tls-key contains the pathname to the key file required when running the web server under HTTPS. The pathname is taken relative to the wiki folder.
See Using HTTPS for details.
The web server configuration parameter username, in conjunction with its companion password:
- Enables Basic Authentication with the specified username/password combination being added to any credentials specified with the credentials parameter
- The specified username is used as a default value for the readers and writers authorization parameters if they are not specified
Examples
Serve anonymous users, setting the username to "joe":
tiddlywik mywikifolder --listen anon-username=joeRestrict access to the user "joe" with a password of "secret":
tiddlywik mywikifolder --listen username=joe password=secretThe web server configuration parameter writers is used to specify the security principals with write access to the wiki. See WebServer Authorization for more details.
La version originale de TiddlyWiki est toujours disponible à l'adresse :
https://classic.tiddlywiki.com.
Il faut savoir que la version courante de TiddlyWiki n'est pas entièrement rétro-compatible avec TiddlyWikiClassic. Le contenu peut être importé mais devra être ajusté pour s'adapter au nouveau format WikiText. Un plugin tw2parser permettant d'afficher fidèlement la plupart des contenus créés avec TiddlyWikiClassic est en cours de développement :
A cross platform server application that can save tiddlers to a local database
https://github.com/opennota/widdly
a minimal self-hosted app, written in Go, that can serve as a backend for a personal TiddlyWiki.
The tm-add-field message is handled by the FieldManglerWidget. It adds the specified field with a blank value if the field doesn't already exist.
| Name | Description |
|---|---|
| param | Name of field to add |
The add field message is usually generated with the ButtonWidget, and is handled by the FieldManglerWidget.
The tm-add-tag message is handled by the FieldManglerWidget. It adds the specified tag.
| Name | Description |
|---|---|
| param | Name of tag to add |
The add tag message is usually generated with the ButtonWidget, and is handled by the FieldManglerWidget.
The autosave wiki message causes the current saver module to perform a background save if it is required.
The autosave wiki message should be generated whenever changes are made to the store. For example, the navigator widget generates the autosave wiki message as part of its handling of the WidgetMessage: tm-save-tiddler, WidgetMessage: tm-delete-tiddler and WidgetMessage: tm-perform-import.
The autosave wiki message is handled by the TiddlyWiki core SyncMechanism which invokes the current SaverModule. Not all SaverModules can handle autosaving.
The tm-browser-refresh message refreshes the page, causing the re-initialisation of any plugin tiddlers. It does not require any properties on the event object.
The refresh message is usually generated with the ButtonWidget and is handled by the core.
The tm-clear-password message clears the current password from the password vault, clearing the $:/isEncrypted tiddler. See EncryptionMechanism for details.
This message is typically generated with the ButtonWidget, and is handled by the core itself.
The "copy to clipboard" message attempts to copy the specified text to the clipboard. If it succeeds, the tiddler $:/language/Notifications/CopiedToClipboard/Succeeded is displayed as a notification. If the browser doesn't permit the operation, the tiddler $:/language/Notifications/CopiedToClipboard/Failed is displayed instead.
It requires the following properties on the event object:
| Name | Description |
|---|---|
| param | Text to be copied to the clipboard |
This message is usually generated with the ButtonWidget. It is handled by the TiddlyWiki core.
Example
This example copies the current time to the clipboard:
<$button message="tm-copy-to-clipboard" param=<<now>>>
Copy date to clipboard
</$button>Affichera ceci :
The download file message causes the current saver module to prompt the user to download the result of parsing a specified template tiddler as a file. It requires the following properties on the event object:
| Name | Description |
|---|---|
| param | Title of a tiddler to use as a template for the new tiddler |
| paramObject | Optional hashmap of variable values to use for the rendering |
The download file message is usually generated with the ButtonWidget.
The download file message is handled by the TiddlyWiki core SyncMechanism which invokes the current SaverModule.
A tm-edit-bitmap-operation invokes one of the available operations on a surrounding bitmap editor. Therefore the message has to be dispatched within the editor in order for it to catch it. The following properties on the event object are required:
| Name | Description |
|---|---|
| param | Name of the operation to be executed, see below for a list of possible operations |
| paramObject | Hashmap of additional parameters required by the operation top be executed |
The tm-edit-bitmap-operation message is usually generated by a ButtonWidget or an ActionWidget and is handled by the surrounding bitmap editor.
Bitmap Operations
At this point the following bitmap operations have been implemented:
| Name | Description | ||||||
|---|---|---|---|---|---|---|---|
| resize | Resizes the image to the specified width and height. Parameters include:
| ||||||
| clear | Clears the contents of the image and fills it with a solid colour. Parameters include:
|
Example
An example can be seen in $:/core/ui/EditorToolbar/size-dropdown:
<$button>
<$action-sendmessage
$message="tm-edit-bitmap-operation"
$param="resize"
width={{$config-title$/new-width}}
height={{$config-title$/new-height}}
/>
...
Resize
</$button>A tm-edit-text-operation invokes one of the available operations on a surrounding text editor. Therefore the message has to be dispatched within the editor in order for it to catch it. The following properties on the event object are required:
| Name | Description |
|---|---|
| param | Name of the operation to be executed, see below for a list of possible operations |
| paramObject | Hashmap of additional parameters required by the operation top be executed |
The tm-edit-text-operation message is usually generated by a ButtonWidget or an ActionWidget and is handled by the surrounding text editor.
Text Operations
At this point the following text operations have been implemented:
| Name | Description | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| excise | Excises the currently selected text into a new tiddler and replaces it with a link, a macro or a transclude of the new tiddler. Parameters include:
| ||||||||||
| replace-all | Replaces all contents of the editor with the provided text.
| ||||||||||
| replace-selection | Replaces the current selection with the provided text.
| ||||||||||
| prefix-lines | Prefixes the currently selected line(s) with the provided character. If a line is already prefixed by the provided prefix, the prefix is removed instead.
Example Setting character=" | ||||||||||
| wrap-lines | Surrounds the selected lines with the provided
| ||||||||||
| wrap-selection | Surrounds the current selection with the provided
| ||||||||||
| save-selection | Saves the text of the current selection into the provided
|
Example
An example can be seen in $:/core/ui/EditorToolbar/bold:
<$action-sendmessage
$message="tm-edit-text-operation"
$param="wrap-selection"
prefix="''"
suffix="''"
/>The tm-fold-all-tiddlers message folds all tiddlers in the current story list. It does so by setting the text of a state tiddler to either "show" or "hide", according to the fold state.
| Name | Description |
|---|---|
| foldedStatePrefix | Prefix for the state tiddler in which the fold state is stored. |
The tm-fold-all-tiddlers message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
The tm-fold-other-tiddlers message folds all tiddlers in the current story list, except the one specified in the param parameter. It does so by setting the text of a state tiddler to either "show" or "hide", according to the fold state.
| Name | Description |
|---|---|
| param | Title of the tiddler that should be ignored by the fold operation. |
| foldedStatePrefix | Prefix for the state tiddler in which the fold state is stored. |
The tm-fold-other-tiddlers message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
The tm-fold-tiddler message folds the tiddler specified in the param parameter. It does so by setting the text of a state tiddler to either "show" or "hide", according to the fold state.
| Name | Description |
|---|---|
| param | Title of the tiddler that should be folded. If the tiddler is already folded, it will be unfolded instead. |
| foldedStatePrefix | Prefix for the state tiddler in which the fold state is stored. If no state prefix is provided, tm-fold-tiddler will do nothing. |
The tm-fold-tiddler message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
The fullscreen message is used to enter, exit or toggle the "fullscreen" mode of the browser, if it supports it. It uses the following properties on the event object:
| Name | Description |
|---|---|
| param | enter to enter full screen mode, exit to exit it, otherwise toggle the full screen status |
The fullscreen message is handled by the TiddlyWiki core.
<$button message="tm-full-screen">
Full screen toggle
</$button>
<$button message="tm-full-screen" param="enter">
Full screen enter
</$button>
<$button message="tm-full-screen" param="exit">
Full screen exit
</$button>Affichera ceci :
Le message tm-home ferme tous les tiddlers ouverts et réouvre les tiddlers par défaut définis dans $:/DefaultTiddlers. Il élimine aussi toute trace de permalien de la barre d’adresse du navigateur internet. Il ne requiert aucune propriété dans l’objet event.
Le message est habituellement lancé à travers le ButtonWidget et est pris en charge par le noyau.
The tm-load-plugin-from-library message load the specified tiddler or plugin from the specified plugin library.
| Name | Description |
|---|---|
| title | Title of the tiddler or plugin to be loaded into the current wiki |
| url | Url specifying the plugin library from which the tiddler or plugin is to be loaded. |
Example
The following snippet will install the CodeMirror plugin from the official plugin library:
<$button>
<$action-sendmessage $message="tm-load-plugin-from-library" title="$:/plugins/tiddlywiki/codemirror" url="https://tiddlywiki.com/library/v5.1.11/index.html"/>
Install CodeMirror
</$button>The tm-load-plugin-from-library message is usually generated with the ButtonWidget and is handled by the core itself.
The tm-load-plugin-library message loads the specified plugin library and imports information about the contained plugins in temporary tiddlers.
| Name | Description |
|---|---|
| url | Url specifying the plugin library to be loaded. |
| infoTitlePrefix | Prefix to the temporary tiddlers being created, containing information about the plugins the plugin library offers. Defaults to $:/temp/RemoteAssetInfo/ |
Example
The following snippet will load the official plugin library:
<$button>
<$action-sendmessage $message="tm-load-plugin-library" infoTitlePrefix="$:/temp/RemoteAssetInfo/" url="https://tiddlywiki.com/library/v5.1.11/index.html"/>
Load official plugin library
</$button>The tm-load-plugin-library message is usually generated with the ButtonWidget and is handled by the core itself.
The login message prompts the user for a username and password and attempts to login to the current serverside host. The tiddler $:/status/IsLoggedIn reflects the current login status with the values "yes" or "no", and $:/status/UserName reflects the current username.
The login message is handled by the TiddlyWiki core SyncMechanism which invokes the current SyncAdaptorModule (typically the tiddlywiki/tiddlywebadaptor plugin).
The logout message attempts to log the user out of the current serverside host. The tiddler $:/status/IsLoggedIn reflects the current login status with the values "yes" or "no", and $:/status/UserName reflects the current username.
The logout message is handled by the TiddlyWiki core SyncMechanism which invokes the current SyncAdaptorModule (typically the tiddlywiki/tiddlywebadaptor plugin).
| Name | Description |
|---|---|
| param | Title of the tiddler to be displayed |
| paramObject | Hashmap of variables to be provided to the modal |
| rootwindow | New in: 5.1.18 yes or true will always display a modal in the wiki-root-window |
The "currentTiddler" variable is set to the title of the modal tiddler, but can be overridden by specifying a different value in paramObject.
The modal message is usually generated with the ButtonWidget. The modal message is handled by the TiddlyWiki core.
Example
Here is an example of displaying a modal and passing parameters to it:
Your name: <$edit-text tiddler="$:/temp/yourName" tag="input" default="Your name"/>
Your message:
<$edit-text tiddler="$:/temp/yourMessage" default="Your message"/>
<$button>
<$action-sendmessage $message="tm-modal" $param="SampleModal" yourName={{$:/temp/yourName}} yourMessage={{$:/temp/yourMessage}}/>
Click me!
</$button>Affichera ceci :
Your name:
Your message:
The tm-navigate message inserts the specified tiddler into the story and puts it at the top of the history stack. If the tiddler is not already present in the story then it will be positioned immediately after the tiddler specified in event.navigateFromTitle.
The navigate message requires the following properties on the event object:
| Name | Description |
|---|---|
| navigateTo | Title of the tiddler that is being navigated |
| navigateFromTitle | Title of the tiddler from which the navigation was initiated |
| navigateFromClientRect | Bounding rectangle in client page coordinates of the element initiating the navigation |
| navigateSuppressNavigation | true causes the new tiddler to only be added to the story, and not the history stack. This suppresses the scrolling associated with navigating to a tiddler |
The navigate message can be generated by the LinkWidget, the ActionNavigateWidget and the ButtonWidget, and is handled by the NavigatorWidget.
The notify message briefly displays a specified tiddler as a small alert in the upper right corner of the page. It requires the following properties on the event object:
| Name | Description |
|---|---|
| param | Title of the tiddler to be displayed |
| paramObject | Hashmap of variables to be provided to the notification |
The notify message is handled by the TiddlyWiki core.
New in: 5.1.14
The tm-open-external-window message opens an external link eg: "http://tiddlywiki.com" in a new browser window. If no parameters are specified, it opens the help tiddler. Any additional parameters passed via the paramObject are being provided as variables to the new window.
| Name | Description |
|---|---|
| param | URL of the tiddler to be opened in a new browser window, defaults to the TiddlyWiki help |
| paramObject | Optional: Hashmap of variables that will be provided to the window. see below |
parmObject
| Name | Description | Important |
|---|---|---|
| windowName | If a parameter is provided it can be used to open different links in the same window eg: _tiddlywiki. Default is empty, so every link opens a new window. | The behaviour is influenced by user settings in the browser and the browsers default behavior! |
| windowFeatures | This parameter needs to be provided as a single string. eg: "height=400, width=600". For detailed description about possible parameters see: Mozilla Help |
The tm-open-external-window message is usually generated with the ButtonWidget or ActionSendMessageWidget and is handled by the core itself.
Examples
<$button>
<$action-sendmessage $message="tm-open-external-window" $param="http://tiddlywiki.com" windowName="_tiddlywiki" windowFeatures="height=500, width=900"/>
Open ~TiddlyWiki - Action
</$button>
<$button>
<$action-sendmessage $message="tm-open-external-window" $param="https://developer.mozilla.org/en-US/docs/Web/API/Window/open" windowName="_tiddlywiki" windowFeatures="height=400, width=600"/>
Open Mozilla Help - Action
</$button>
<$button message="tm-open-external-window" param="http://tiddlywiki.com" >
Open ~TiddlyWiki - Button
</$button>Affichera ceci :
The tm-open-window message opens a tiddler in a new browser window. If no parameters are specified, the current tiddler is opened in a new window. Similiar to tm-modal any additional parameters passed via the paramObject are being provided as variables to the new window.
| Name | Description |
|---|---|
| param | Title of the tiddler to be opened in a new browser window, defaults to currentTiddler if empty |
| template | Template in which the tiddler will be rendered in |
| width | Width of the new browser window |
| height | Height of the new browser window |
| paramObject | Hashmap of variables that will be provided to the window |
The tm-open-window message is usually generated with the ButtonWidget and is handled by the core itself.
The tm-permalink message changes the browser address bar to form a permalink to a specified tiddler, defaulting to the current tiddler.
The permalink message supports the following properties on the event object:
| Name | Description |
|---|---|
| param | Title of the tiddler to be permalinked |
| tiddlerTitle | The current tiddler (used by default if the tiddler title isn't specified in the param) |
The permalink message can be generated by the ButtonWidget, and is handled by the story mechanism.
The tm-permaview message changes the browser address bar to form a permaview that specifies all the open tiddlers in the main story river, and the tiddler to be navigated, defaulting to the current tiddler.
The permaview message supports the following properties on the event object:
| Name | Description |
|---|---|
| param | Title of the tiddler to be navigated within the permaview |
| tiddlerTitle | The current tiddler (used by default if the tiddler title isn't specified in the param) |
The permaview message can be generated by the ButtonWidget, and is handled by the story mechanism.
New in: 5.1.14 The tm-print message causes the browser to display the print dialog for the current page. It does not require any properties on the event object.
The print message is usually generated with the ButtonWidget and is handled by the core.
The tm-remove-field message is handled by the FieldManglerWidget. It removes the specified field.
| Name | Description |
|---|---|
| param | Name of field to remove |
The remove field message is usually generated with the ButtonWidget, and is handled by the FieldManglerWidget.
The tm-remove-tag message is handled by the FieldManglerWidget. It removes the specified tag.
| Name | Description |
|---|---|
| param | Name of tag to remove |
The remove tag message is usually generated with the ButtonWidget, and is handled by the FieldManglerWidget.
The save wiki message causes the current saver module to perform a full save operation. The save operation can involve user interaction. It requires the following properties on the event object:
| Name | Description |
|---|---|
| param | Title of a tiddler to use as a template for rendering the wiki (defaults to $:/core/save/all) |
| paramObject | Optional hashmap of variable values to use for the rendering |
The save wiki message is usually generated by the ButtonWidget.
The save wiki message is handled by the TiddlyWiki core SyncMechanism which invokes the current SaverModule.
The tm-scroll message causes the surrounding scrollable container to scroll to the specified DOM node into view. The tm-scroll is handled in various places in the core itself, but can also be handled by a ScrollableWidget.
| Name | Description |
|---|---|
| target | Target DOM node the scrollable container should scroll to. |
Due to the nature of the parameter, the tm-scroll can only be generated within javascript code.
The server refresh message attempts to synchronise the latest changes to the current serverside host.
The server refresh message is handled by the TiddlyWiki core SyncMechanism which invokes the current SyncAdaptorModule (typically the tiddlywiki/tiddlywebadaptor plugin).
The tm-set-password message prompts the user for a new password and stores it in the password vault, replacing any existing password. It also sets the $:/isEncrypted tiddler. See EncryptionMechanism for details.
This message is typically generated with the ButtonWidget, and is handled by the core itself.
The tm-unfold-all-tiddlers message unfolds all tiddlers in the current story list. It does so by setting the text of a state tiddler to either "show" or "hide", according to the fold state.
| Name | Description |
|---|---|
| foldedStatePrefix | Prefix for the state tiddler in which the fold state is stored. |
The tm-unfold-all-tiddlers message is usually generated with the ButtonWidget and is handled by the surrounding NavigatorWidget.
L'affichage de TiddlyWiki est piloté par un ensemble de widgets sous-jacents. Ceux-ci sont organisés dans une structure arborescente : chaque widget a un widget parent et zéro ou plusieurs widgets enfants.
TiddlyWiki génère cet arbre widget par l'analyse WikiText des tiddlers. Chaque composant de la syntaxe WikiText, y compris le cas trivial du texte ordinaire, génère le widget correspondant. L'arborescence widget est une représentation intermédiaire, rendue, par la suite, dans l'affichage réel final.
Les Widgets sont similaires aux éléments HTML d'un document. En fait, les balises HTML dans Wikitext génèrent des éléments widgets dédiés.
Chaque classe de widget contribue a une aptitude spécifique de la fonctionnalité globale, comme l'aptitude à afficher une image, un bouton, pour appeler une macro, transclure un texte externe, ou pour marquer une partie du texte comme titre.
Les widget plus spécialisés utilisent une syntaxe de widget polyvalente comme seule représentation WikiText possible.
Les classes de widget suivantes sont intégrées au noyau :
- action-createtiddler
- action-deletefield
- action-deletetiddler
- action-listops
- action-navigate
- action-sendmessage
- action-setfield
- ActionWidgets
- browse
- button
- checkbox
- codeblock
- count
- diff-text
- draggable
- droppable
- dropzone
- edit-bitmap
- edit-text
- edit
- encrypt
- entity
- fieldmangler
- fields
- image
- importvariables
- keyboard
- linkcatcher
- link
- list
- macrocall
- navigator
- password
- radio
- range
- reveal
- scrollable
- select
- setvariable
- set
- text
- tiddler
- transclude
- vars
- view
- wikify
Les widgets enrichissent les fonctionnalités du WikiText. Ils ont la même syntaxe que les éléments HTML, mais leur nom de balise commence toujours par $. Par exemple :
<$button message="tm-close-tiddler">Fermez Moi !</$button>Notez que les widgets héritent de toutes les caractéristiques du HTML dans WikiText:
- Les attributs des Widgets peuvent être spécifiés via :
- Des chaines non-cotées (sans aucun espace)
- Des chaines cotées par simple ou double cotes
- Des chaines cotées par des doubles cotés triplées
- Des invocations de Macro (eg
attr=<<maMacro>>) - Des transclusions (eg,
attr={{MonTiddler!!champ}})
- Le contenu d'un widget est analysé en mode en ligne jusqu'à ce que l'ouverture d'une balise soit suivie par deux sautsdeligne, ce qui force le mode bloc
- Le 'mode Enligne' indique que les règles d'analyse en 'mode bloc' de rubriques, tables, listes, ... ne sont pas reconnues
Voir HTML dans WikiText pour plus de détails.
Les widgets disponibles inclus :
- action-createtiddler
- action-deletefield
- action-deletetiddler
- action-listops
- action-navigate
- action-sendmessage
- action-setfield
- ActionWidgets
- browse
- button
- checkbox
- codeblock
- count
- diff-text
- draggable
- droppable
- dropzone
- edit-bitmap
- edit-text
- edit
- encrypt
- entity
- fieldmangler
- fields
- image
- importvariables
- keyboard
- linkcatcher
- link
- list
- macrocall
- navigator
- password
- radio
- range
- reveal
- scrollable
- select
- setvariable
- set
- text
- tiddler
- transclude
- vars
- view
- wikify
Introduction
The wikify widget parses and renders a string of text and assigns the result to a specified variable. The new value of the variable is available to the content within the wikify widget.
Content and Attributes
The content of the <$wikify> widget is the scope for the value assigned to the variable.
| Attribute | Description |
|---|---|
| name | The name of the variable to assign |
| text | The text to parse and render |
| type | The ContentType of the text (defaults to text/vnd.tiddlywiki) |
| mode | The parse mode: block (the default) or inline |
| output | Keyword indicating the desired output type, defaulting to text (see below) |
The available output types are:
| Keyword | Description |
|---|---|
| text | Return the plain text of the rendered output (ie HTML tags are omitted) |
| formattedtext | Return the plain text with simple text formatting of the rendered output (ie HTML tags are omitted) |
| html | Return the rendered HTML of the output |
| parsetree | Return a formatted JSON representation of the parse tree |
| widgettree | Return a formatted JSON representation of the widget tree |
Le WikiText est le langage de balisage de TiddlyWiki, qui permet d'écrire de manière concise et expressive une grande variété de formatages de texte, de liens hypertextes et de fonctionnalités interactives. Il permet de se concentrer sur l'écriture, sans l'interférence d'une interface complexe. Il est conçu pour être familier aux utilisateurs de Markdown, tout en étant plus focalisé sur les liens et les fonctionnalités interactives.
Voir Formater du texte dans TiddlyWiki pour une introduction au WikiText.
Les syntaxes suivantes sont intégrées nativement dans TiddlyWiki :
Under Windows it is possible to convert TiddlyWiki into a true local application by renaming the HTML file to have the extension *.hta. The fsosaver module can then use the ActiveX FileSystemObject to save changes.
Note that one disadvantage of this approach is that the TiddlyWiki file is saved in UTF-16 format, making it up to twice as large as it would be with the usual UTF-8 encoding. However, opening and saving the file via another saving method will re-encode the file to UTF-8.
See Wikipedia for more details: http://en.wikipedia.org/wiki/HTML_Application
Introduction
If you want to contribute to TiddlyWiki's development, rather than installing TiddlyWiki in the usual way, you can work directly with the GitHub repository.
Mario Pietsch has created a short video introduction.
Setting Up
- Create an account on GitHub if you don't already have one
- Fork the TiddlyWiki5 GitHub repository from https://github.com/Jermolene/TiddlyWiki5
- Clone a local copy of your fork
- Open a command line terminal and change the current working directory to the root of the repo
- Type
npm link(Windows) orsudo npm link(Mac/Linux) to tell npm to use this copy of the repo as the globally installed one
After this procedure you can work with TiddlyWiki5 via npm as though it were installed in the usual way with npm install -g tiddlywiki.
See also Scripts for TiddlyWiki on Node.js.
Informations pour vous mettre le pied à l'étrier :
- La première règle d'utilisation de TiddlyWiki
- La mise en route
- Bien démarrer en vidéo
- Obtenir la dernière version
- Navigation parmi les tiddlers ouverts
- Utiliser des liens pour naviguer entre les tiddlers
- Chercher avec TiddlyWiki
- Créer et modifier des tiddlers
- Créer des tiddlers journaux
- Sauvegarder les modifications
- Formater du texte dans TiddlyWiki
- Structurer TiddlyWiki
- Étiqueter par tag
- Images
- Raccourcis clavier
- Cryptage
- Introduction Vidéo
- Audio
- Navigateurs compatibles
- Performance
The XLSX Utilities edition of TiddlyWiki contains tools to work with .XLSX spreadsheets generated by applications like Microsoft Excel and Google Sheets. It can be used in the browser or under Node.js.